first commit

store/activity.go

@@ -0,0 +1,64 @@
+package store
+
+import (
+	"context"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+)
+
+type ActivityType string
+
+const (
+	ActivityTypeMemoComment ActivityType = "MEMO_COMMENT"
+)
+
+func (t ActivityType) String() string {
+	return string(t)
+}
+
+type ActivityLevel string
+
+const (
+	ActivityLevelInfo ActivityLevel = "INFO"
+)
+
+func (l ActivityLevel) String() string {
+	return string(l)
+}
+
+type Activity struct {
+	ID int32
+
+	// Standard fields
+	CreatorID int32
+	CreatedTs int64
+
+	// Domain specific fields
+	Type    ActivityType
+	Level   ActivityLevel
+	Payload *storepb.ActivityPayload
+}
+
+type FindActivity struct {
+	ID   *int32
+	Type *ActivityType
+}
+
+func (s *Store) CreateActivity(ctx context.Context, create *Activity) (*Activity, error) {
+	return s.driver.CreateActivity(ctx, create)
+}
+
+func (s *Store) ListActivities(ctx context.Context, find *FindActivity) ([]*Activity, error) {
+	return s.driver.ListActivities(ctx, find)
+}
+
+func (s *Store) GetActivity(ctx context.Context, find *FindActivity) (*Activity, error) {
+	list, err := s.ListActivities(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+	if len(list) == 0 {
+		return nil, nil
+	}
+	return list[0], nil
+}

store/attachment.go

@@ -0,0 +1,172 @@
+package store
+
+import (
+	"context"
+	"log/slog"
+	"os"
+	"path/filepath"
+
+	"github.com/pkg/errors"
+
+	"github.com/usememos/memos/internal/base"
+	"github.com/usememos/memos/plugin/storage/s3"
+	storepb "github.com/usememos/memos/proto/gen/store"
+)
+
+type Attachment struct {
+	// ID is the system generated unique identifier for the attachment.
+	ID int32
+	// UID is the user defined unique identifier for the attachment.
+	UID string
+
+	// Standard fields
+	CreatorID int32
+	CreatedTs int64
+	UpdatedTs int64
+
+	// Domain specific fields
+	Filename    string
+	Blob        []byte
+	Type        string
+	Size        int64
+	StorageType storepb.AttachmentStorageType
+	Reference   string
+	Payload     *storepb.AttachmentPayload
+
+	// The related memo ID.
+	MemoID *int32
+
+	// Composed field
+	MemoUID *string
+}
+
+type FindAttachment struct {
+	GetBlob        bool
+	ID             *int32
+	UID            *string
+	CreatorID      *int32
+	Filename       *string
+	FilenameSearch *string
+	MemoID         *int32
+	MemoIDList     []int32
+	HasRelatedMemo bool
+	StorageType    *storepb.AttachmentStorageType
+	Filters        []string
+	Limit          *int
+	Offset         *int
+}
+
+type UpdateAttachment struct {
+	ID        int32
+	UID       *string
+	UpdatedTs *int64
+	Filename  *string
+	MemoID    *int32
+	Reference *string
+	Payload   *storepb.AttachmentPayload
+}
+
+type DeleteAttachment struct {
+	ID     int32
+	MemoID *int32
+}
+
+func (s *Store) CreateAttachment(ctx context.Context, create *Attachment) (*Attachment, error) {
+	if !base.UIDMatcher.MatchString(create.UID) {
+		return nil, errors.New("invalid uid")
+	}
+	return s.driver.CreateAttachment(ctx, create)
+}
+
+func (s *Store) ListAttachments(ctx context.Context, find *FindAttachment) ([]*Attachment, error) {
+	// Set default limits to prevent loading too many attachments at once
+	shouldApplyDefaultLimit := find.Limit == nil && len(find.MemoIDList) == 0
+	if shouldApplyDefaultLimit && find.GetBlob {
+		// When fetching blobs, we should be especially careful with limits
+		defaultLimit := 10
+		find.Limit = &defaultLimit
+	} else if shouldApplyDefaultLimit {
+		// Even without blobs, let's default to a reasonable limit
+		defaultLimit := 100
+		find.Limit = &defaultLimit
+	}
+
+	return s.driver.ListAttachments(ctx, find)
+}
+
+func (s *Store) GetAttachment(ctx context.Context, find *FindAttachment) (*Attachment, error) {
+	attachments, err := s.ListAttachments(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+
+	if len(attachments) == 0 {
+		return nil, nil
+	}
+
+	return attachments[0], nil
+}
+
+func (s *Store) UpdateAttachment(ctx context.Context, update *UpdateAttachment) error {
+	if update.UID != nil && !base.UIDMatcher.MatchString(*update.UID) {
+		return errors.New("invalid uid")
+	}
+	return s.driver.UpdateAttachment(ctx, update)
+}
+
+func (s *Store) DeleteAttachment(ctx context.Context, delete *DeleteAttachment) error {
+	attachment, err := s.GetAttachment(ctx, &FindAttachment{ID: &delete.ID})
+	if err != nil {
+		return errors.Wrap(err, "failed to get attachment")
+	}
+	if attachment == nil {
+		return errors.New("attachment not found")
+	}
+
+	if attachment.StorageType == storepb.AttachmentStorageType_LOCAL {
+		if err := func() error {
+			p := filepath.FromSlash(attachment.Reference)
+			if !filepath.IsAbs(p) {
+				p = filepath.Join(s.profile.Data, p)
+			}
+			err := os.Remove(p)
+			if err != nil && !os.IsNotExist(err) {
+				return errors.Wrap(err, "failed to delete local file")
+			}
+			return nil
+		}(); err != nil {
+			return errors.Wrap(err, "failed to delete local file")
+		}
+	} else if attachment.StorageType == storepb.AttachmentStorageType_S3 {
+		if err := func() error {
+			s3ObjectPayload := attachment.Payload.GetS3Object()
+			if s3ObjectPayload == nil {
+				return errors.Errorf("No s3 object found")
+			}
+			instanceStorageSetting, err := s.GetInstanceStorageSetting(ctx)
+			if err != nil {
+				return errors.Wrap(err, "failed to get instance storage setting")
+			}
+			s3Config := s3ObjectPayload.S3Config
+			if s3Config == nil {
+				if instanceStorageSetting.S3Config == nil {
+					return errors.Errorf("S3 config is not found")
+				}
+				s3Config = instanceStorageSetting.S3Config
+			}
+
+			s3Client, err := s3.NewClient(ctx, s3Config)
+			if err != nil {
+				return errors.Wrap(err, "Failed to create s3 client")
+			}
+			if err := s3Client.DeleteObject(ctx, s3ObjectPayload.Key); err != nil {
+				return errors.Wrap(err, "Failed to delete s3 object")
+			}
+			return nil
+		}(); err != nil {
+			slog.Warn("Failed to delete s3 object", slog.Any("err", err))
+		}
+	}
+
+	return s.driver.DeleteAttachment(ctx, delete)
+}

store/cache.go

@@ -0,0 +1,9 @@
+package store
+
+import (
+	"fmt"
+)
+
+func getUserSettingCacheKey(userID int32, key string) string {
+	return fmt.Sprintf("%d-%s", userID, key)
+}

store/cache/cache.go

@@ -0,0 +1,327 @@
+package cache
+
+import (
+	"context"
+	"sync"
+	"sync/atomic"
+	"time"
+)
+
+// Interface defines the operations a cache must support.
+type Interface interface {
+	// Set adds a value to the cache with the default TTL.
+	Set(ctx context.Context, key string, value any)
+
+	// SetWithTTL adds a value to the cache with a custom TTL.
+	SetWithTTL(ctx context.Context, key string, value any, ttl time.Duration)
+
+	// Get retrieves a value from the cache.
+	Get(ctx context.Context, key string) (any, bool)
+
+	// Delete removes a value from the cache.
+	Delete(ctx context.Context, key string)
+
+	// Clear removes all values from the cache.
+	Clear(ctx context.Context)
+
+	// Size returns the number of items in the cache.
+	Size() int64
+
+	// Close stops all background tasks and releases resources.
+	Close() error
+}
+
+// item represents a cached value with metadata.
+type item struct {
+	value      any
+	expiration time.Time
+	size       int // Approximate size in bytes
+}
+
+// Config contains options for configuring a cache.
+type Config struct {
+	// DefaultTTL is the default time-to-live for cache entries.
+	DefaultTTL time.Duration
+
+	// CleanupInterval is how often the cache runs cleanup.
+	CleanupInterval time.Duration
+
+	// MaxItems is the maximum number of items allowed in the cache.
+	MaxItems int
+
+	// OnEviction is called when an item is evicted from the cache.
+	OnEviction func(key string, value any)
+}
+
+// DefaultConfig returns a default configuration for the cache.
+func DefaultConfig() Config {
+	return Config{
+		DefaultTTL:      10 * time.Minute,
+		CleanupInterval: 5 * time.Minute,
+		MaxItems:        1000,
+		OnEviction:      nil,
+	}
+}
+
+// Cache is a thread-safe in-memory cache with TTL and memory management.
+type Cache struct {
+	itemCount  atomic.Int64 // Use atomic operations to track item count
+	data       sync.Map
+	config     Config
+	stopChan   chan struct{}
+	closedChan chan struct{}
+}
+
+// New creates a new memory cache with the given configuration.
+func New(config Config) *Cache {
+	c := &Cache{
+		config:     config,
+		stopChan:   make(chan struct{}),
+		closedChan: make(chan struct{}),
+	}
+
+	go c.cleanupLoop()
+	return c
+}
+
+// NewDefault creates a new memory cache with default configuration.
+func NewDefault() *Cache {
+	return New(DefaultConfig())
+}
+
+// Set adds a value to the cache with the default TTL.
+func (c *Cache) Set(ctx context.Context, key string, value any) {
+	c.SetWithTTL(ctx, key, value, c.config.DefaultTTL)
+}
+
+// SetWithTTL adds a value to the cache with a custom TTL.
+func (c *Cache) SetWithTTL(_ context.Context, key string, value any, ttl time.Duration) {
+	// Estimate size of the item (very rough approximation).
+	size := estimateSize(value)
+
+	// Check if item already exists to avoid double counting.
+	if _, exists := c.data.Load(key); exists {
+		c.data.Delete(key)
+	} else {
+		// Only increment if this is a new key.
+		(&c.itemCount).Add(1)
+	}
+
+	c.data.Store(key, item{
+		value:      value,
+		expiration: time.Now().Add(ttl),
+		size:       size,
+	})
+
+	// If we're over the max items, clean up old items.
+	if c.config.MaxItems > 0 && (&c.itemCount).Load() > int64(c.config.MaxItems) {
+		c.cleanupOldest()
+	}
+}
+
+// Get retrieves a value from the cache.
+func (c *Cache) Get(_ context.Context, key string) (any, bool) {
+	value, ok := c.data.Load(key)
+	if !ok {
+		return nil, false
+	}
+
+	itm, ok := value.(item)
+	if !ok {
+		// If the value is not of type item, it means it was corrupted or not set correctly.
+		c.data.Delete(key)
+		return nil, false
+	}
+	if time.Now().After(itm.expiration) {
+		c.data.Delete(key)
+		(&c.itemCount).Add(-1)
+
+		if c.config.OnEviction != nil {
+			c.config.OnEviction(key, itm.value)
+		}
+
+		return nil, false
+	}
+
+	return itm.value, true
+}
+
+// Delete removes a value from the cache.
+func (c *Cache) Delete(_ context.Context, key string) {
+	if value, loaded := c.data.LoadAndDelete(key); loaded {
+		(&c.itemCount).Add(-1)
+
+		if c.config.OnEviction != nil {
+			if itm, ok := value.(item); ok {
+				c.config.OnEviction(key, itm.value)
+			}
+		}
+	}
+}
+
+// Clear removes all values from the cache.
+func (c *Cache) Clear(_ context.Context) {
+	count := 0
+	c.data.Range(func(key, value any) bool {
+		if c.config.OnEviction != nil {
+			itm, ok := value.(item)
+			if ok {
+				if keyStr, ok := key.(string); ok {
+					c.config.OnEviction(keyStr, itm.value)
+				}
+			}
+		}
+		c.data.Delete(key)
+		count++
+		return true
+	})
+	(&c.itemCount).Store(0)
+}
+
+// Size returns the number of items in the cache.
+func (c *Cache) Size() int64 {
+	return (&c.itemCount).Load()
+}
+
+// Close stops the cache cleanup goroutine.
+func (c *Cache) Close() error {
+	select {
+	case <-c.stopChan:
+		// Already closed
+		return nil
+	default:
+		close(c.stopChan)
+		<-c.closedChan // Wait for cleanup goroutine to exit
+		return nil
+	}
+}
+
+// cleanupLoop periodically cleans up expired items.
+func (c *Cache) cleanupLoop() {
+	ticker := time.NewTicker(c.config.CleanupInterval)
+	defer func() {
+		ticker.Stop()
+		close(c.closedChan)
+	}()
+
+	for {
+		select {
+		case <-ticker.C:
+			c.cleanup()
+		case <-c.stopChan:
+			return
+		}
+	}
+}
+
+// cleanup removes expired items.
+func (c *Cache) cleanup() {
+	evicted := make(map[string]any)
+	count := 0
+
+	c.data.Range(func(key, value any) bool {
+		itm, ok := value.(item)
+		if !ok {
+			return true
+		}
+		if time.Now().After(itm.expiration) {
+			c.data.Delete(key)
+			count++
+
+			if c.config.OnEviction != nil {
+				if keyStr, ok := key.(string); ok {
+					evicted[keyStr] = itm.value
+				}
+			}
+		}
+		return true
+	})
+
+	if count > 0 {
+		(&c.itemCount).Add(-int64(count))
+
+		// Call eviction callbacks outside the loop to avoid blocking the range
+		if c.config.OnEviction != nil {
+			for k, v := range evicted {
+				c.config.OnEviction(k, v)
+			}
+		}
+	}
+}
+
+// cleanupOldest removes the oldest items if we're over the max items.
+func (c *Cache) cleanupOldest() {
+	// Remove 20% of max items at once
+	threshold := max(c.config.MaxItems/5, 1)
+
+	currentCount := (&c.itemCount).Load()
+
+	// If we're not over the threshold, don't do anything
+	if currentCount <= int64(c.config.MaxItems) {
+		return
+	}
+
+	// Find the oldest items
+	type keyExpPair struct {
+		key        string
+		value      any
+		expiration time.Time
+	}
+	candidates := make([]keyExpPair, 0, threshold)
+
+	c.data.Range(func(key, value any) bool {
+		itm, ok := value.(item)
+		if !ok {
+			return true
+		}
+		if keyStr, ok := key.(string); ok && len(candidates) < threshold {
+			candidates = append(candidates, keyExpPair{keyStr, itm.value, itm.expiration})
+			return true
+		}
+
+		// Find the newest item in candidates
+		newestIdx := 0
+		for i := 1; i < len(candidates); i++ {
+			if candidates[i].expiration.After(candidates[newestIdx].expiration) {
+				newestIdx = i
+			}
+		}
+
+		// Replace it if this item is older
+		if itm.expiration.Before(candidates[newestIdx].expiration) {
+			candidates[newestIdx] = keyExpPair{key.(string), itm.value, itm.expiration}
+		}
+
+		return true
+	})
+
+	// Delete the oldest items
+	deletedCount := 0
+	for _, candidate := range candidates {
+		c.data.Delete(candidate.key)
+		deletedCount++
+
+		if c.config.OnEviction != nil {
+			c.config.OnEviction(candidate.key, candidate.value)
+		}
+	}
+
+	// Update count
+	if deletedCount > 0 {
+		(&c.itemCount).Add(-int64(deletedCount))
+	}
+}
+
+// estimateSize attempts to estimate the memory footprint of a value.
+func estimateSize(value any) int {
+	switch v := value.(type) {
+	case string:
+		return len(v) + 24 // base size + string overhead
+	case []byte:
+		return len(v) + 24 // base size + slice overhead
+	case map[string]any:
+		return len(v) * 64 // rough estimate
+	default:
+		return 64 // default conservative estimate
+	}
+}

store/cache/cache_test.go

@@ -0,0 +1,209 @@
+package cache
+
+import (
+	"context"
+	"fmt"
+	"sync"
+	"testing"
+	"time"
+)
+
+func TestCacheBasicOperations(t *testing.T) {
+	ctx := context.Background()
+	config := DefaultConfig()
+	config.DefaultTTL = 100 * time.Millisecond
+	config.CleanupInterval = 50 * time.Millisecond
+	cache := New(config)
+	defer cache.Close()
+
+	// Test Set and Get
+	cache.Set(ctx, "key1", "value1")
+	if val, ok := cache.Get(ctx, "key1"); !ok || val != "value1" {
+		t.Errorf("Expected 'value1', got %v, exists: %v", val, ok)
+	}
+
+	// Test SetWithTTL
+	cache.SetWithTTL(ctx, "key2", "value2", 200*time.Millisecond)
+	if val, ok := cache.Get(ctx, "key2"); !ok || val != "value2" {
+		t.Errorf("Expected 'value2', got %v, exists: %v", val, ok)
+	}
+
+	// Test Delete
+	cache.Delete(ctx, "key1")
+	if _, ok := cache.Get(ctx, "key1"); ok {
+		t.Error("Key 'key1' should have been deleted")
+	}
+
+	// Test automatic expiration
+	time.Sleep(150 * time.Millisecond)
+	if _, ok := cache.Get(ctx, "key1"); ok {
+		t.Error("Key 'key1' should have expired")
+	}
+	// key2 should still be valid (200ms TTL)
+	if _, ok := cache.Get(ctx, "key2"); !ok {
+		t.Error("Key 'key2' should still be valid")
+	}
+
+	// Wait for key2 to expire
+	time.Sleep(100 * time.Millisecond)
+	if _, ok := cache.Get(ctx, "key2"); ok {
+		t.Error("Key 'key2' should have expired")
+	}
+
+	// Test Clear
+	cache.Set(ctx, "key3", "value3")
+	cache.Clear(ctx)
+	if _, ok := cache.Get(ctx, "key3"); ok {
+		t.Error("Cache should be empty after Clear()")
+	}
+}
+
+func TestCacheEviction(t *testing.T) {
+	ctx := context.Background()
+	config := DefaultConfig()
+	config.MaxItems = 5
+	cache := New(config)
+	defer cache.Close()
+
+	// Add 5 items (max capacity)
+	for i := 0; i < 5; i++ {
+		key := fmt.Sprintf("key%d", i)
+		cache.Set(ctx, key, i)
+	}
+
+	// Verify all 5 items are in the cache
+	for i := 0; i < 5; i++ {
+		key := fmt.Sprintf("key%d", i)
+		if _, ok := cache.Get(ctx, key); !ok {
+			t.Errorf("Key '%s' should be in the cache", key)
+		}
+	}
+
+	// Add 2 more items to trigger eviction
+	cache.Set(ctx, "keyA", "valueA")
+	cache.Set(ctx, "keyB", "valueB")
+
+	// Verify size is still within limits
+	if cache.Size() > int64(config.MaxItems) {
+		t.Errorf("Cache size %d exceeds limit %d", cache.Size(), config.MaxItems)
+	}
+
+	// Some of the original keys should have been evicted
+	evictedCount := 0
+	for i := 0; i < 5; i++ {
+		key := fmt.Sprintf("key%d", i)
+		if _, ok := cache.Get(ctx, key); !ok {
+			evictedCount++
+		}
+	}
+
+	if evictedCount == 0 {
+		t.Error("No keys were evicted despite exceeding max items")
+	}
+
+	// The newer keys should still be present
+	if _, ok := cache.Get(ctx, "keyA"); !ok {
+		t.Error("Key 'keyA' should be in the cache")
+	}
+	if _, ok := cache.Get(ctx, "keyB"); !ok {
+		t.Error("Key 'keyB' should be in the cache")
+	}
+}
+
+func TestCacheConcurrency(t *testing.T) {
+	ctx := context.Background()
+	cache := NewDefault()
+	defer cache.Close()
+
+	const goroutines = 10
+	const operationsPerGoroutine = 100
+
+	var wg sync.WaitGroup
+	wg.Add(goroutines)
+
+	for i := 0; i < goroutines; i++ {
+		go func(id int) {
+			defer wg.Done()
+
+			baseKey := fmt.Sprintf("worker%d-", id)
+
+			// Set operations
+			for j := 0; j < operationsPerGoroutine; j++ {
+				key := fmt.Sprintf("%skey%d", baseKey, j)
+				value := fmt.Sprintf("value%d-%d", id, j)
+				cache.Set(ctx, key, value)
+			}
+
+			// Get operations
+			for j := 0; j < operationsPerGoroutine; j++ {
+				key := fmt.Sprintf("%skey%d", baseKey, j)
+				val, ok := cache.Get(ctx, key)
+				if !ok {
+					t.Errorf("Key '%s' should exist in cache", key)
+					continue
+				}
+				expected := fmt.Sprintf("value%d-%d", id, j)
+				if val != expected {
+					t.Errorf("For key '%s', expected '%s', got '%s'", key, expected, val)
+				}
+			}
+
+			// Delete half the keys
+			for j := 0; j < operationsPerGoroutine/2; j++ {
+				key := fmt.Sprintf("%skey%d", baseKey, j)
+				cache.Delete(ctx, key)
+			}
+		}(i)
+	}
+
+	wg.Wait()
+
+	// Verify size and deletion
+	var totalKeysExpected int64 = goroutines * operationsPerGoroutine / 2
+	if cache.Size() != totalKeysExpected {
+		t.Errorf("Expected cache size to be %d, got %d", totalKeysExpected, cache.Size())
+	}
+}
+
+func TestEvictionCallback(t *testing.T) {
+	ctx := context.Background()
+	evicted := make(map[string]interface{})
+	evictedMu := sync.Mutex{}
+
+	config := DefaultConfig()
+	config.DefaultTTL = 50 * time.Millisecond
+	config.CleanupInterval = 25 * time.Millisecond
+	config.OnEviction = func(key string, value interface{}) {
+		evictedMu.Lock()
+		evicted[key] = value
+		evictedMu.Unlock()
+	}
+
+	cache := New(config)
+	defer cache.Close()
+
+	// Add items
+	cache.Set(ctx, "key1", "value1")
+	cache.Set(ctx, "key2", "value2")
+
+	// Manually delete
+	cache.Delete(ctx, "key1")
+
+	// Verify manual deletion triggered callback
+	time.Sleep(10 * time.Millisecond) // Small delay to ensure callback processed
+	evictedMu.Lock()
+	if evicted["key1"] != "value1" {
+		t.Error("Eviction callback not triggered for manual deletion")
+	}
+	evictedMu.Unlock()
+
+	// Wait for automatic expiration
+	time.Sleep(60 * time.Millisecond)
+
+	// Verify TTL expiration triggered callback
+	evictedMu.Lock()
+	if evicted["key2"] != "value2" {
+		t.Error("Eviction callback not triggered for TTL expiration")
+	}
+	evictedMu.Unlock()
+}

store/common.go

@@ -0,0 +1,24 @@
+package store
+
+import "google.golang.org/protobuf/encoding/protojson"
+
+var (
+	protojsonUnmarshaler = protojson.UnmarshalOptions{
+		AllowPartial:   true,
+		DiscardUnknown: true,
+	}
+)
+
+// RowStatus is the status for a row.
+type RowStatus string
+
+const (
+	// Normal is the status for a normal row.
+	Normal RowStatus = "NORMAL"
+	// Archived is the status for an archived row.
+	Archived RowStatus = "ARCHIVED"
+)
+
+func (r RowStatus) String() string {
+	return string(r)
+}

store/db/db.go

@@ -0,0 +1,32 @@
+package db
+
+import (
+	"github.com/pkg/errors"
+
+	"github.com/usememos/memos/internal/profile"
+	"github.com/usememos/memos/store"
+	"github.com/usememos/memos/store/db/mysql"
+	"github.com/usememos/memos/store/db/postgres"
+	"github.com/usememos/memos/store/db/sqlite"
+)
+
+// NewDBDriver creates new db driver based on profile.
+func NewDBDriver(profile *profile.Profile) (store.Driver, error) {
+	var driver store.Driver
+	var err error
+
+	switch profile.Driver {
+	case "sqlite":
+		driver, err = sqlite.NewDB(profile)
+	case "mysql":
+		driver, err = mysql.NewDB(profile)
+	case "postgres":
+		driver, err = postgres.NewDB(profile)
+	default:
+		return nil, errors.New("unknown db driver")
+	}
+	if err != nil {
+		return nil, errors.Wrap(err, "failed to create db driver")
+	}
+	return driver, nil
+}

store/db/mysql/activity.go

@@ -0,0 +1,93 @@
+package mysql
+
+import (
+	"context"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateActivity(ctx context.Context, create *store.Activity) (*store.Activity, error) {
+	payloadString := "{}"
+	if create.Payload != nil {
+		bytes, err := protojson.Marshal(create.Payload)
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to marshal activity payload")
+		}
+		payloadString = string(bytes)
+	}
+	fields := []string{"`creator_id`", "`type`", "`level`", "`payload`"}
+	placeholder := []string{"?", "?", "?", "?"}
+	args := []any{create.CreatorID, create.Type.String(), create.Level.String(), payloadString}
+
+	stmt := "INSERT INTO `activity` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ")"
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return nil, errors.Wrap(err, "failed to execute statement")
+	}
+
+	id, err := result.LastInsertId()
+	if err != nil {
+		return nil, errors.Wrap(err, "failed to get last insert id")
+	}
+
+	id32 := int32(id)
+
+	list, err := d.ListActivities(ctx, &store.FindActivity{ID: &id32})
+	if err != nil || len(list) == 0 {
+		return nil, errors.Wrap(err, "failed to find activity")
+	}
+
+	return list[0], nil
+}
+
+func (d *DB) ListActivities(ctx context.Context, find *store.FindActivity) ([]*store.Activity, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if find.ID != nil {
+		where, args = append(where, "`id` = ?"), append(args, *find.ID)
+	}
+	if find.Type != nil {
+		where, args = append(where, "`type` = ?"), append(args, find.Type.String())
+	}
+
+	query := "SELECT `id`, `creator_id`, `type`, `level`, `payload`, UNIX_TIMESTAMP(`created_ts`) FROM `activity` WHERE " + strings.Join(where, " AND ") + " ORDER BY `created_ts` DESC"
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.Activity{}
+	for rows.Next() {
+		activity := &store.Activity{}
+		var payloadBytes []byte
+		if err := rows.Scan(
+			&activity.ID,
+			&activity.CreatorID,
+			&activity.Type,
+			&activity.Level,
+			&payloadBytes,
+			&activity.CreatedTs,
+		); err != nil {
+			return nil, err
+		}
+
+		payload := &storepb.ActivityPayload{}
+		if err := protojsonUnmarshaler.Unmarshal(payloadBytes, payload); err != nil {
+			return nil, err
+		}
+		activity.Payload = payload
+		list = append(list, activity)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}

store/db/mysql/attachment.go

@@ -0,0 +1,241 @@
+package mysql
+
+import (
+	"context"
+	"database/sql"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	"github.com/usememos/memos/plugin/filter"
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateAttachment(ctx context.Context, create *store.Attachment) (*store.Attachment, error) {
+	fields := []string{"`uid`", "`filename`", "`blob`", "`type`", "`size`", "`creator_id`", "`memo_id`", "`storage_type`", "`reference`", "`payload`"}
+	placeholder := []string{"?", "?", "?", "?", "?", "?", "?", "?", "?", "?"}
+	storageType := ""
+	if create.StorageType != storepb.AttachmentStorageType_ATTACHMENT_STORAGE_TYPE_UNSPECIFIED {
+		storageType = create.StorageType.String()
+	}
+	payloadString := "{}"
+	if create.Payload != nil {
+		bytes, err := protojson.Marshal(create.Payload)
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to marshal attachment payload")
+		}
+		payloadString = string(bytes)
+	}
+	args := []any{create.UID, create.Filename, create.Blob, create.Type, create.Size, create.CreatorID, create.MemoID, storageType, create.Reference, payloadString}
+
+	stmt := "INSERT INTO `attachment` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ")"
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return nil, err
+	}
+
+	id, err := result.LastInsertId()
+	if err != nil {
+		return nil, err
+	}
+
+	id32 := int32(id)
+	return d.GetAttachment(ctx, &store.FindAttachment{ID: &id32})
+}
+
+func (d *DB) ListAttachments(ctx context.Context, find *store.FindAttachment) ([]*store.Attachment, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if v := find.ID; v != nil {
+		where, args = append(where, "`attachment`.`id` = ?"), append(args, *v)
+	}
+	if v := find.UID; v != nil {
+		where, args = append(where, "`attachment`.`uid` = ?"), append(args, *v)
+	}
+	if v := find.CreatorID; v != nil {
+		where, args = append(where, "`attachment`.`creator_id` = ?"), append(args, *v)
+	}
+	if v := find.Filename; v != nil {
+		where, args = append(where, "`attachment`.`filename` = ?"), append(args, *v)
+	}
+	if v := find.FilenameSearch; v != nil {
+		where, args = append(where, "`attachment`.`filename` LIKE ?"), append(args, "%"+*v+"%")
+	}
+	if v := find.MemoID; v != nil {
+		where, args = append(where, "`attachment`.`memo_id` = ?"), append(args, *v)
+	}
+	if len(find.MemoIDList) > 0 {
+		placeholders := make([]string, 0, len(find.MemoIDList))
+		for range find.MemoIDList {
+			placeholders = append(placeholders, "?")
+		}
+		where = append(where, "`attachment`.`memo_id` IN ("+strings.Join(placeholders, ",")+")")
+		for _, id := range find.MemoIDList {
+			args = append(args, id)
+		}
+	}
+	if find.HasRelatedMemo {
+		where = append(where, "`attachment`.`memo_id` IS NOT NULL")
+	}
+	if find.StorageType != nil {
+		where, args = append(where, "`attachment`.`storage_type` = ?"), append(args, find.StorageType.String())
+	}
+
+	if len(find.Filters) > 0 {
+		engine, err := filter.DefaultAttachmentEngine()
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to get filter engine")
+		}
+		if err := filter.AppendConditions(ctx, engine, find.Filters, filter.DialectMySQL, &where, &args); err != nil {
+			return nil, errors.Wrap(err, "failed to append filter conditions")
+		}
+	}
+
+	fields := []string{
+		"`attachment`.`id` AS `id`",
+		"`attachment`.`uid` AS `uid`",
+		"`attachment`.`filename` AS `filename`",
+		"`attachment`.`type` AS `type`",
+		"`attachment`.`size` AS `size`",
+		"`attachment`.`creator_id` AS `creator_id`",
+		"UNIX_TIMESTAMP(`attachment`.`created_ts`) AS `created_ts`",
+		"UNIX_TIMESTAMP(`attachment`.`updated_ts`) AS `updated_ts`",
+		"`attachment`.`memo_id` AS `memo_id`",
+		"`attachment`.`storage_type` AS `storage_type`",
+		"`attachment`.`reference` AS `reference`",
+		"`attachment`.`payload` AS `payload`",
+		"CASE WHEN `memo`.`uid` IS NOT NULL THEN `memo`.`uid` ELSE NULL END AS `memo_uid`",
+	}
+	if find.GetBlob {
+		fields = append(fields, "`attachment`.`blob` AS `blob`")
+	}
+
+	query := "SELECT " + strings.Join(fields, ", ") + " FROM `attachment`" + " " +
+		"LEFT JOIN `memo` ON `attachment`.`memo_id` = `memo`.`id`" + " " +
+		"WHERE " + strings.Join(where, " AND ") + " " +
+		"ORDER BY `updated_ts` DESC"
+	if find.Limit != nil {
+		query = fmt.Sprintf("%s LIMIT %d", query, *find.Limit)
+		if find.Offset != nil {
+			query = fmt.Sprintf("%s OFFSET %d", query, *find.Offset)
+		}
+	}
+
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := make([]*store.Attachment, 0)
+	for rows.Next() {
+		attachment := store.Attachment{}
+		var memoID sql.NullInt32
+		var storageType string
+		var payloadBytes []byte
+		dests := []any{
+			&attachment.ID,
+			&attachment.UID,
+			&attachment.Filename,
+			&attachment.Type,
+			&attachment.Size,
+			&attachment.CreatorID,
+			&attachment.CreatedTs,
+			&attachment.UpdatedTs,
+			&memoID,
+			&storageType,
+			&attachment.Reference,
+			&payloadBytes,
+			&attachment.MemoUID,
+		}
+		if find.GetBlob {
+			dests = append(dests, &attachment.Blob)
+		}
+		if err := rows.Scan(dests...); err != nil {
+			return nil, err
+		}
+
+		if memoID.Valid {
+			attachment.MemoID = &memoID.Int32
+		}
+		attachment.StorageType = storepb.AttachmentStorageType(storepb.AttachmentStorageType_value[storageType])
+		payload := &storepb.AttachmentPayload{}
+		if err := protojsonUnmarshaler.Unmarshal(payloadBytes, payload); err != nil {
+			return nil, err
+		}
+		attachment.Payload = payload
+		list = append(list, &attachment)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) GetAttachment(ctx context.Context, find *store.FindAttachment) (*store.Attachment, error) {
+	list, err := d.ListAttachments(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+	if len(list) == 0 {
+		return nil, nil
+	}
+
+	return list[0], nil
+}
+
+func (d *DB) UpdateAttachment(ctx context.Context, update *store.UpdateAttachment) error {
+	set, args := []string{}, []any{}
+
+	if v := update.UID; v != nil {
+		set, args = append(set, "`uid` = ?"), append(args, *v)
+	}
+	if v := update.UpdatedTs; v != nil {
+		set, args = append(set, "`updated_ts` = FROM_UNIXTIME(?)"), append(args, *v)
+	}
+	if v := update.Filename; v != nil {
+		set, args = append(set, "`filename` = ?"), append(args, *v)
+	}
+	if v := update.MemoID; v != nil {
+		set, args = append(set, "`memo_id` = ?"), append(args, *v)
+	}
+	if v := update.Reference; v != nil {
+		set, args = append(set, "`reference` = ?"), append(args, *v)
+	}
+	if v := update.Payload; v != nil {
+		bytes, err := protojson.Marshal(v)
+		if err != nil {
+			return errors.Wrap(err, "failed to marshal attachment payload")
+		}
+		set, args = append(set, "`payload` = ?"), append(args, string(bytes))
+	}
+
+	args = append(args, update.ID)
+	stmt := "UPDATE `attachment` SET " + strings.Join(set, ", ") + " WHERE `id` = ?"
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}
+
+func (d *DB) DeleteAttachment(ctx context.Context, delete *store.DeleteAttachment) error {
+	stmt := "DELETE FROM `attachment` WHERE `id` = ?"
+	result, err := d.db.ExecContext(ctx, stmt, delete.ID)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+
+	return nil
+}

store/db/mysql/common.go

@@ -0,0 +1,10 @@
+package mysql
+
+import "google.golang.org/protobuf/encoding/protojson"
+
+var (
+	protojsonUnmarshaler = protojson.UnmarshalOptions{
+		AllowPartial:   true,
+		DiscardUnknown: true,
+	}
+)

store/db/mysql/idp.go

@@ -0,0 +1,126 @@
+package mysql
+
+import (
+	"context"
+	"strings"
+
+	"github.com/pkg/errors"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateIdentityProvider(ctx context.Context, create *store.IdentityProvider) (*store.IdentityProvider, error) {
+	placeholders := []string{"?", "?", "?", "?"}
+	fields := []string{"`name`", "`type`", "`identifier_filter`", "`config`"}
+	args := []any{create.Name, create.Type.String(), create.IdentifierFilter, create.Config}
+
+	stmt := "INSERT INTO `idp` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholders, ", ") + ")"
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return nil, err
+	}
+
+	id, err := result.LastInsertId()
+	if err != nil {
+		return nil, err
+	}
+
+	create.ID = int32(id)
+	return create, nil
+}
+
+func (d *DB) ListIdentityProviders(ctx context.Context, find *store.FindIdentityProvider) ([]*store.IdentityProvider, error) {
+	where, args := []string{"1 = 1"}, []any{}
+	if v := find.ID; v != nil {
+		where, args = append(where, "`id` = ?"), append(args, *v)
+	}
+
+	rows, err := d.db.QueryContext(ctx, "SELECT `id`, `name`, `type`, `identifier_filter`, `config` FROM `idp` WHERE "+strings.Join(where, " AND ")+" ORDER BY `id` ASC",
+		args...,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	var identityProviders []*store.IdentityProvider
+	for rows.Next() {
+		var identityProvider store.IdentityProvider
+		var typeString string
+		if err := rows.Scan(
+			&identityProvider.ID,
+			&identityProvider.Name,
+			&typeString,
+			&identityProvider.IdentifierFilter,
+			&identityProvider.Config,
+		); err != nil {
+			return nil, err
+		}
+		identityProvider.Type = storepb.IdentityProvider_Type(storepb.IdentityProvider_Type_value[typeString])
+		identityProviders = append(identityProviders, &identityProvider)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return identityProviders, nil
+}
+
+func (d *DB) GetIdentityProvider(ctx context.Context, find *store.FindIdentityProvider) (*store.IdentityProvider, error) {
+	list, err := d.ListIdentityProviders(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+	if len(list) == 0 {
+		return nil, nil
+	}
+
+	identityProvider := list[0]
+	return identityProvider, nil
+}
+
+func (d *DB) UpdateIdentityProvider(ctx context.Context, update *store.UpdateIdentityProvider) (*store.IdentityProvider, error) {
+	set, args := []string{}, []any{}
+	if v := update.Name; v != nil {
+		set, args = append(set, "`name` = ?"), append(args, *v)
+	}
+	if v := update.IdentifierFilter; v != nil {
+		set, args = append(set, "`identifier_filter` = ?"), append(args, *v)
+	}
+	if v := update.Config; v != nil {
+		set, args = append(set, "`config` = ?"), append(args, *v)
+	}
+	args = append(args, update.ID)
+
+	stmt := "UPDATE `idp` SET " + strings.Join(set, ", ") + " WHERE `id` = ?"
+	_, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return nil, err
+	}
+
+	identityProvider, err := d.GetIdentityProvider(ctx, &store.FindIdentityProvider{
+		ID: &update.ID,
+	})
+	if err != nil {
+		return nil, err
+	}
+	if identityProvider == nil {
+		return nil, errors.Errorf("idp %d not found", update.ID)
+	}
+	return identityProvider, nil
+}
+
+func (d *DB) DeleteIdentityProvider(ctx context.Context, delete *store.DeleteIdentityProvider) error {
+	where, args := []string{"`id` = ?"}, []any{delete.ID}
+	stmt := "DELETE FROM `idp` WHERE " + strings.Join(where, " AND ")
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return err
+	}
+	if _, err = result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/mysql/inbox.go

@@ -0,0 +1,150 @@
+package mysql
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateInbox(ctx context.Context, create *store.Inbox) (*store.Inbox, error) {
+	messageString := "{}"
+	if create.Message != nil {
+		bytes, err := protojson.Marshal(create.Message)
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to marshal inbox message")
+		}
+		messageString = string(bytes)
+	}
+
+	fields := []string{"`sender_id`", "`receiver_id`", "`status`", "`message`"}
+	placeholder := []string{"?", "?", "?", "?"}
+	args := []any{create.SenderID, create.ReceiverID, create.Status, messageString}
+
+	stmt := "INSERT INTO `inbox` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ")"
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return nil, err
+	}
+
+	id, err := result.LastInsertId()
+	if err != nil {
+		return nil, err
+	}
+
+	id32 := int32(id)
+	inbox, err := d.GetInbox(ctx, &store.FindInbox{ID: &id32})
+	if err != nil {
+		return nil, err
+	}
+	return inbox, nil
+}
+
+func (d *DB) ListInboxes(ctx context.Context, find *store.FindInbox) ([]*store.Inbox, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if find.ID != nil {
+		where, args = append(where, "`id` = ?"), append(args, *find.ID)
+	}
+	if find.SenderID != nil {
+		where, args = append(where, "`sender_id` = ?"), append(args, *find.SenderID)
+	}
+	if find.ReceiverID != nil {
+		where, args = append(where, "`receiver_id` = ?"), append(args, *find.ReceiverID)
+	}
+	if find.Status != nil {
+		where, args = append(where, "`status` = ?"), append(args, *find.Status)
+	}
+	if find.MessageType != nil {
+		// Filter by message type using JSON extraction
+		// Note: The type field in JSON is stored as string representation of the enum name
+		if *find.MessageType == storepb.InboxMessage_TYPE_UNSPECIFIED {
+			where, args = append(where, "(JSON_EXTRACT(`message`, '$.type') IS NULL OR JSON_EXTRACT(`message`, '$.type') = ?)"), append(args, find.MessageType.String())
+		} else {
+			where, args = append(where, "JSON_EXTRACT(`message`, '$.type') = ?"), append(args, find.MessageType.String())
+		}
+	}
+
+	query := "SELECT `id`, UNIX_TIMESTAMP(`created_ts`), `sender_id`, `receiver_id`, `status`, `message` FROM `inbox` WHERE " + strings.Join(where, " AND ") + " ORDER BY `created_ts` DESC"
+	if find.Limit != nil {
+		query = fmt.Sprintf("%s LIMIT %d", query, *find.Limit)
+		if find.Offset != nil {
+			query = fmt.Sprintf("%s OFFSET %d", query, *find.Offset)
+		}
+	}
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.Inbox{}
+	for rows.Next() {
+		inbox := &store.Inbox{}
+		var messageBytes []byte
+		if err := rows.Scan(
+			&inbox.ID,
+			&inbox.CreatedTs,
+			&inbox.SenderID,
+			&inbox.ReceiverID,
+			&inbox.Status,
+			&messageBytes,
+		); err != nil {
+			return nil, err
+		}
+
+		message := &storepb.InboxMessage{}
+		if err := protojsonUnmarshaler.Unmarshal(messageBytes, message); err != nil {
+			return nil, err
+		}
+		inbox.Message = message
+		list = append(list, inbox)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) GetInbox(ctx context.Context, find *store.FindInbox) (*store.Inbox, error) {
+	list, err := d.ListInboxes(ctx, find)
+	if err != nil {
+		return nil, errors.Wrap(err, "failed to get inbox")
+	}
+	if len(list) != 1 {
+		return nil, errors.Errorf("unexpected inbox count: %d", len(list))
+	}
+	return list[0], nil
+}
+
+func (d *DB) UpdateInbox(ctx context.Context, update *store.UpdateInbox) (*store.Inbox, error) {
+	set, args := []string{"`status` = ?"}, []any{update.Status.String()}
+	args = append(args, update.ID)
+	query := "UPDATE `inbox` SET " + strings.Join(set, ", ") + " WHERE `id` = ?"
+	if _, err := d.db.ExecContext(ctx, query, args...); err != nil {
+		return nil, errors.Wrap(err, "failed to update inbox")
+	}
+	inbox, err := d.GetInbox(ctx, &store.FindInbox{ID: &update.ID})
+	if err != nil {
+		return nil, err
+	}
+	return inbox, nil
+}
+
+func (d *DB) DeleteInbox(ctx context.Context, delete *store.DeleteInbox) error {
+	result, err := d.db.ExecContext(ctx, "DELETE FROM `inbox` WHERE `id` = ?", delete.ID)
+	if err != nil {
+		return errors.Wrap(err, "failed to delete inbox")
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/mysql/instance_setting.go

@@ -0,0 +1,65 @@
+package mysql
+
+import (
+	"context"
+	"strings"
+
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertInstanceSetting(ctx context.Context, upsert *store.InstanceSetting) (*store.InstanceSetting, error) {
+	stmt := "INSERT INTO `system_setting` (`name`, `value`, `description`) VALUES (?, ?, ?) ON DUPLICATE KEY UPDATE `value` = ?, `description` = ?"
+	_, err := d.db.ExecContext(
+		ctx,
+		stmt,
+		upsert.Name,
+		upsert.Value,
+		upsert.Description,
+		upsert.Value,
+		upsert.Description,
+	)
+	if err != nil {
+		return nil, err
+	}
+
+	return upsert, nil
+}
+
+func (d *DB) ListInstanceSettings(ctx context.Context, find *store.FindInstanceSetting) ([]*store.InstanceSetting, error) {
+	where, args := []string{"1 = 1"}, []any{}
+	if find.Name != "" {
+		where, args = append(where, "`name` = ?"), append(args, find.Name)
+	}
+
+	query := "SELECT `name`, `value`, `description` FROM `system_setting` WHERE " + strings.Join(where, " AND ")
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.InstanceSetting{}
+	for rows.Next() {
+		systemSettingMessage := &store.InstanceSetting{}
+		if err := rows.Scan(
+			&systemSettingMessage.Name,
+			&systemSettingMessage.Value,
+			&systemSettingMessage.Description,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, systemSettingMessage)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) DeleteInstanceSetting(ctx context.Context, delete *store.DeleteInstanceSetting) error {
+	stmt := "DELETE FROM `system_setting` WHERE `name` = ?"
+	_, err := d.db.ExecContext(ctx, stmt, delete.Name)
+	return err
+}

store/db/mysql/memo.go

@@ -0,0 +1,269 @@
+package mysql
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	"github.com/usememos/memos/plugin/filter"
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateMemo(ctx context.Context, create *store.Memo) (*store.Memo, error) {
+	fields := []string{"`uid`", "`creator_id`", "`content`", "`visibility`", "`payload`"}
+	placeholder := []string{"?", "?", "?", "?", "?"}
+	payload := "{}"
+	if create.Payload != nil {
+		payloadBytes, err := protojson.Marshal(create.Payload)
+		if err != nil {
+			return nil, err
+		}
+		payload = string(payloadBytes)
+	}
+	args := []any{create.UID, create.CreatorID, create.Content, create.Visibility, payload}
+
+	// Add custom timestamps if provided
+	if create.CreatedTs != 0 {
+		fields = append(fields, "`created_ts`")
+		placeholder = append(placeholder, "FROM_UNIXTIME(?)")
+		args = append(args, create.CreatedTs)
+	}
+	if create.UpdatedTs != 0 {
+		fields = append(fields, "`updated_ts`")
+		placeholder = append(placeholder, "FROM_UNIXTIME(?)")
+		args = append(args, create.UpdatedTs)
+	}
+
+	stmt := "INSERT INTO `memo` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ")"
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return nil, err
+	}
+
+	rawID, err := result.LastInsertId()
+	if err != nil {
+		return nil, err
+	}
+	id := int32(rawID)
+	memo, err := d.GetMemo(ctx, &store.FindMemo{ID: &id})
+	if err != nil {
+		return nil, err
+	}
+	if memo == nil {
+		return nil, errors.Errorf("failed to create memo")
+	}
+	return memo, nil
+}
+
+func (d *DB) ListMemos(ctx context.Context, find *store.FindMemo) ([]*store.Memo, error) {
+	where, having, args := []string{"1 = 1"}, []string{"1 = 1"}, []any{}
+
+	engine, err := filter.DefaultEngine()
+	if err != nil {
+		return nil, err
+	}
+	if err := filter.AppendConditions(ctx, engine, find.Filters, filter.DialectMySQL, &where, &args); err != nil {
+		return nil, err
+	}
+	if v := find.ID; v != nil {
+		where, args = append(where, "`memo`.`id` = ?"), append(args, *v)
+	}
+	if len(find.IDList) > 0 {
+		placeholders := make([]string, 0, len(find.IDList))
+		for range find.IDList {
+			placeholders = append(placeholders, "?")
+		}
+		where = append(where, "`memo`.`id` IN ("+strings.Join(placeholders, ",")+")")
+		for _, id := range find.IDList {
+			args = append(args, id)
+		}
+	}
+	if v := find.UID; v != nil {
+		where, args = append(where, "`memo`.`uid` = ?"), append(args, *v)
+	}
+	if len(find.UIDList) > 0 {
+		placeholders := make([]string, 0, len(find.UIDList))
+		for range find.UIDList {
+			placeholders = append(placeholders, "?")
+		}
+		where = append(where, "`memo`.`uid` IN ("+strings.Join(placeholders, ",")+")")
+		for _, uid := range find.UIDList {
+			args = append(args, uid)
+		}
+	}
+	if v := find.CreatorID; v != nil {
+		where, args = append(where, "`memo`.`creator_id` = ?"), append(args, *v)
+	}
+	if v := find.RowStatus; v != nil {
+		where, args = append(where, "`memo`.`row_status` = ?"), append(args, *v)
+	}
+	if v := find.VisibilityList; len(v) != 0 {
+		placeholder := []string{}
+		for _, visibility := range v {
+			placeholder = append(placeholder, "?")
+			args = append(args, visibility.String())
+		}
+		where = append(where, fmt.Sprintf("`memo`.`visibility` in (%s)", strings.Join(placeholder, ",")))
+	}
+	if find.ExcludeComments {
+		having = append(having, "`parent_uid` IS NULL")
+	}
+
+	order := "DESC"
+	if find.OrderByTimeAsc {
+		order = "ASC"
+	}
+	orderBy := []string{}
+	if find.OrderByPinned {
+		orderBy = append(orderBy, "`pinned` DESC")
+	}
+	if find.OrderByUpdatedTs {
+		orderBy = append(orderBy, "`updated_ts` "+order)
+	} else {
+		orderBy = append(orderBy, "`created_ts` "+order)
+	}
+	// Add id as final tie-breaker
+	orderBy = append(orderBy, "`id` DESC")
+	fields := []string{
+		"`memo`.`id` AS `id`",
+		"`memo`.`uid` AS `uid`",
+		"`memo`.`creator_id` AS `creator_id`",
+		"UNIX_TIMESTAMP(`memo`.`created_ts`) AS `created_ts`",
+		"UNIX_TIMESTAMP(`memo`.`updated_ts`) AS `updated_ts`",
+		"`memo`.`row_status` AS `row_status`",
+		"`memo`.`visibility` AS `visibility`",
+		"`memo`.`pinned` AS `pinned`",
+		"`memo`.`payload` AS `payload`",
+		"CASE WHEN `parent_memo`.`uid` IS NOT NULL THEN `parent_memo`.`uid` ELSE NULL END AS `parent_uid`",
+	}
+	if !find.ExcludeContent {
+		fields = append(fields, "`memo`.`content` AS `content`")
+	}
+
+	query := "SELECT " + strings.Join(fields, ", ") + " FROM `memo`" + " " +
+		"LEFT JOIN `memo_relation` ON `memo`.`id` = `memo_relation`.`memo_id` AND `memo_relation`.`type` = 'COMMENT'" + " " +
+		"LEFT JOIN `memo` AS `parent_memo` ON `memo_relation`.`related_memo_id` = `parent_memo`.`id`" + " " +
+		"WHERE " + strings.Join(where, " AND ") + " " +
+		"HAVING " + strings.Join(having, " AND ") + " " +
+		"ORDER BY " + strings.Join(orderBy, ", ")
+	if find.Limit != nil {
+		query = fmt.Sprintf("%s LIMIT %d", query, *find.Limit)
+		if find.Offset != nil {
+			query = fmt.Sprintf("%s OFFSET %d", query, *find.Offset)
+		}
+	}
+
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := make([]*store.Memo, 0)
+	for rows.Next() {
+		var memo store.Memo
+		var payloadBytes []byte
+		dests := []any{
+			&memo.ID,
+			&memo.UID,
+			&memo.CreatorID,
+			&memo.CreatedTs,
+			&memo.UpdatedTs,
+			&memo.RowStatus,
+			&memo.Visibility,
+			&memo.Pinned,
+			&payloadBytes,
+			&memo.ParentUID,
+		}
+		if !find.ExcludeContent {
+			dests = append(dests, &memo.Content)
+		}
+		if err := rows.Scan(dests...); err != nil {
+			return nil, err
+		}
+		payload := &storepb.MemoPayload{}
+		if err := protojsonUnmarshaler.Unmarshal(payloadBytes, payload); err != nil {
+			return nil, errors.Wrap(err, "failed to unmarshal payload")
+		}
+		memo.Payload = payload
+		list = append(list, &memo)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) GetMemo(ctx context.Context, find *store.FindMemo) (*store.Memo, error) {
+	list, err := d.ListMemos(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+	if len(list) == 0 {
+		return nil, nil
+	}
+
+	memo := list[0]
+	return memo, nil
+}
+
+func (d *DB) UpdateMemo(ctx context.Context, update *store.UpdateMemo) error {
+	set, args := []string{}, []any{}
+	if v := update.UID; v != nil {
+		set, args = append(set, "`uid` = ?"), append(args, *v)
+	}
+	if v := update.CreatedTs; v != nil {
+		set, args = append(set, "`created_ts` = FROM_UNIXTIME(?)"), append(args, *v)
+	}
+	if v := update.UpdatedTs; v != nil {
+		set, args = append(set, "`updated_ts` = FROM_UNIXTIME(?)"), append(args, *v)
+	}
+	if v := update.RowStatus; v != nil {
+		set, args = append(set, "`row_status` = ?"), append(args, *v)
+	}
+	if v := update.Content; v != nil {
+		set, args = append(set, "`content` = ?"), append(args, *v)
+	}
+	if v := update.Visibility; v != nil {
+		set, args = append(set, "`visibility` = ?"), append(args, *v)
+	}
+	if v := update.Pinned; v != nil {
+		set, args = append(set, "`pinned` = ?"), append(args, *v)
+	}
+	if v := update.Payload; v != nil {
+		payloadBytes, err := protojson.Marshal(v)
+		if err != nil {
+			return err
+		}
+		set, args = append(set, "`payload` = ?"), append(args, string(payloadBytes))
+	}
+	if len(set) == 0 {
+		return nil
+	}
+	args = append(args, update.ID)
+
+	stmt := "UPDATE `memo` SET " + strings.Join(set, ", ") + " WHERE `id` = ?"
+	if _, err := d.db.ExecContext(ctx, stmt, args...); err != nil {
+		return err
+	}
+	return nil
+}
+
+func (d *DB) DeleteMemo(ctx context.Context, delete *store.DeleteMemo) error {
+	where, args := []string{"`id` = ?"}, []any{delete.ID}
+	stmt := "DELETE FROM `memo` WHERE " + strings.Join(where, " AND ")
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/mysql/memo_relation.go

@@ -0,0 +1,110 @@
+package mysql
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/usememos/memos/plugin/filter"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertMemoRelation(ctx context.Context, create *store.MemoRelation) (*store.MemoRelation, error) {
+	stmt := "INSERT INTO `memo_relation` (`memo_id`, `related_memo_id`, `type`) VALUES (?, ?, ?) ON DUPLICATE KEY UPDATE `type` = `type`"
+	_, err := d.db.ExecContext(
+		ctx,
+		stmt,
+		create.MemoID,
+		create.RelatedMemoID,
+		create.Type,
+	)
+	if err != nil {
+		return nil, err
+	}
+
+	memoRelation := store.MemoRelation{
+		MemoID:        create.MemoID,
+		RelatedMemoID: create.RelatedMemoID,
+		Type:          create.Type,
+	}
+
+	return &memoRelation, nil
+}
+
+func (d *DB) ListMemoRelations(ctx context.Context, find *store.FindMemoRelation) ([]*store.MemoRelation, error) {
+	where, args := []string{"TRUE"}, []any{}
+	if find.MemoID != nil {
+		where, args = append(where, "`memo_id` = ?"), append(args, find.MemoID)
+	}
+	if find.RelatedMemoID != nil {
+		where, args = append(where, "`related_memo_id` = ?"), append(args, find.RelatedMemoID)
+	}
+	if find.Type != nil {
+		where, args = append(where, "`type` = ?"), append(args, find.Type)
+	}
+	if find.MemoFilter != nil {
+		engine, err := filter.DefaultEngine()
+		if err != nil {
+			return nil, err
+		}
+		stmt, err := engine.CompileToStatement(ctx, *find.MemoFilter, filter.RenderOptions{
+			Dialect:           filter.DialectMySQL,
+			PlaceholderOffset: 0,
+		})
+		if err != nil {
+			return nil, err
+		}
+		if stmt.SQL != "" {
+			where = append(where, fmt.Sprintf("memo_id IN (SELECT id FROM memo WHERE %s)", stmt.SQL))
+			where = append(where, fmt.Sprintf("related_memo_id IN (SELECT id FROM memo WHERE %s)", stmt.SQL))
+			args = append(args, append(stmt.Args, stmt.Args...)...)
+		}
+	}
+
+	rows, err := d.db.QueryContext(ctx, "SELECT `memo_id`, `related_memo_id`, `type` FROM `memo_relation` WHERE "+strings.Join(where, " AND "), args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.MemoRelation{}
+	for rows.Next() {
+		memoRelation := &store.MemoRelation{}
+		if err := rows.Scan(
+			&memoRelation.MemoID,
+			&memoRelation.RelatedMemoID,
+			&memoRelation.Type,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, memoRelation)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) DeleteMemoRelation(ctx context.Context, delete *store.DeleteMemoRelation) error {
+	where, args := []string{"TRUE"}, []any{}
+	if delete.MemoID != nil {
+		where, args = append(where, "`memo_id` = ?"), append(args, delete.MemoID)
+	}
+	if delete.RelatedMemoID != nil {
+		where, args = append(where, "`related_memo_id` = ?"), append(args, delete.RelatedMemoID)
+	}
+	if delete.Type != nil {
+		where, args = append(where, "`type` = ?"), append(args, delete.Type)
+	}
+	stmt := "DELETE FROM `memo_relation` WHERE " + strings.Join(where, " AND ")
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return err
+	}
+	if _, err = result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/mysql/mysql.go

@@ -0,0 +1,68 @@
+package mysql
+
+import (
+	"context"
+	"database/sql"
+
+	"github.com/go-sql-driver/mysql"
+	"github.com/pkg/errors"
+
+	"github.com/usememos/memos/internal/profile"
+	"github.com/usememos/memos/store"
+)
+
+type DB struct {
+	db      *sql.DB
+	profile *profile.Profile
+	config  *mysql.Config
+}
+
+func NewDB(profile *profile.Profile) (store.Driver, error) {
+	// Open MySQL connection with parameter.
+	// multiStatements=true is required for migration.
+	// See more in: https://github.com/go-sql-driver/mysql#multistatements
+	dsn, err := mergeDSN(profile.DSN)
+	if err != nil {
+		return nil, err
+	}
+
+	driver := DB{profile: profile}
+	driver.config, err = mysql.ParseDSN(dsn)
+	if err != nil {
+		return nil, errors.New("Parse DSN eroor")
+	}
+
+	driver.db, err = sql.Open("mysql", dsn)
+	if err != nil {
+		return nil, errors.Wrapf(err, "failed to open db: %s", profile.DSN)
+	}
+
+	return &driver, nil
+}
+
+func (d *DB) GetDB() *sql.DB {
+	return d.db
+}
+
+func (d *DB) Close() error {
+	return d.db.Close()
+}
+
+func (d *DB) IsInitialized(ctx context.Context) (bool, error) {
+	var exists bool
+	err := d.db.QueryRowContext(ctx, "SELECT EXISTS (SELECT 1 FROM information_schema.tables WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'memo' AND TABLE_TYPE = 'BASE TABLE')").Scan(&exists)
+	if err != nil {
+		return false, errors.Wrap(err, "failed to check if database is initialized")
+	}
+	return exists, nil
+}
+
+func mergeDSN(baseDSN string) (string, error) {
+	config, err := mysql.ParseDSN(baseDSN)
+	if err != nil {
+		return "", errors.Wrapf(err, "failed to parse DSN: %s", baseDSN)
+	}
+
+	config.MultiStatements = true
+	return config.FormatDSN(), nil
+}

store/db/mysql/reaction.go

@@ -0,0 +1,113 @@
+package mysql
+
+import (
+	"context"
+	"strings"
+
+	"github.com/pkg/errors"
+
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertReaction(ctx context.Context, upsert *store.Reaction) (*store.Reaction, error) {
+	fields := []string{"`creator_id`", "`content_id`", "`reaction_type`"}
+	placeholder := []string{"?", "?", "?"}
+	args := []interface{}{upsert.CreatorID, upsert.ContentID, upsert.ReactionType}
+	stmt := "INSERT INTO `reaction` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ")"
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return nil, err
+	}
+
+	rawID, err := result.LastInsertId()
+	if err != nil {
+		return nil, err
+	}
+	id := int32(rawID)
+	reaction, err := d.GetReaction(ctx, &store.FindReaction{ID: &id})
+	if err != nil {
+		return nil, err
+	}
+	if reaction == nil {
+		return nil, errors.Errorf("failed to create reaction")
+	}
+	return reaction, nil
+}
+
+func (d *DB) ListReactions(ctx context.Context, find *store.FindReaction) ([]*store.Reaction, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if find.ID != nil {
+		where, args = append(where, "`id` = ?"), append(args, *find.ID)
+	}
+	if find.CreatorID != nil {
+		where, args = append(where, "`creator_id` = ?"), append(args, *find.CreatorID)
+	}
+	if find.ContentID != nil {
+		where, args = append(where, "`content_id` = ?"), append(args, *find.ContentID)
+	}
+	if len(find.ContentIDList) > 0 {
+		placeholders := make([]string, 0, len(find.ContentIDList))
+		for _, id := range find.ContentIDList {
+			placeholders = append(placeholders, "?")
+			args = append(args, id)
+		}
+		where = append(where, "`content_id` IN ("+strings.Join(placeholders, ",")+")")
+	}
+
+	rows, err := d.db.QueryContext(ctx, `
+		SELECT
+			id,
+			UNIX_TIMESTAMP(created_ts) AS created_ts,
+			creator_id,
+			content_id,
+			reaction_type
+		FROM reaction
+		WHERE `+strings.Join(where, " AND ")+`
+		ORDER BY id ASC`,
+		args...,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.Reaction{}
+	for rows.Next() {
+		reaction := &store.Reaction{}
+		if err := rows.Scan(
+			&reaction.ID,
+			&reaction.CreatedTs,
+			&reaction.CreatorID,
+			&reaction.ContentID,
+			&reaction.ReactionType,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, reaction)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) GetReaction(ctx context.Context, find *store.FindReaction) (*store.Reaction, error) {
+	list, err := d.ListReactions(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+	if len(list) == 0 {
+		return nil, nil
+	}
+
+	reaction := list[0]
+	return reaction, nil
+}
+
+func (d *DB) DeleteReaction(ctx context.Context, delete *store.DeleteReaction) error {
+	_, err := d.db.ExecContext(ctx, "DELETE FROM `reaction` WHERE `id` = ?", delete.ID)
+	return err
+}

store/db/mysql/user.go

@@ -0,0 +1,166 @@
+package mysql
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateUser(ctx context.Context, create *store.User) (*store.User, error) {
+	fields := []string{"`username`", "`role`", "`email`", "`nickname`", "`password_hash`", "`avatar_url`"}
+	placeholder := []string{"?", "?", "?", "?", "?", "?"}
+	args := []any{create.Username, create.Role, create.Email, create.Nickname, create.PasswordHash, create.AvatarURL}
+
+	stmt := "INSERT INTO user (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ")"
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return nil, err
+	}
+
+	id, err := result.LastInsertId()
+	if err != nil {
+		return nil, err
+	}
+
+	id32 := int32(id)
+	list, err := d.ListUsers(ctx, &store.FindUser{ID: &id32})
+	if err != nil {
+		return nil, err
+	}
+	if len(list) != 1 {
+		return nil, errors.Errorf("unexpected user count: %d", len(list))
+	}
+
+	return list[0], nil
+}
+
+func (d *DB) UpdateUser(ctx context.Context, update *store.UpdateUser) (*store.User, error) {
+	set, args := []string{}, []any{}
+	if v := update.UpdatedTs; v != nil {
+		set, args = append(set, "`updated_ts` = FROM_UNIXTIME(?)"), append(args, *v)
+	}
+	if v := update.RowStatus; v != nil {
+		set, args = append(set, "`row_status` = ?"), append(args, *v)
+	}
+	if v := update.Username; v != nil {
+		set, args = append(set, "`username` = ?"), append(args, *v)
+	}
+	if v := update.Email; v != nil {
+		set, args = append(set, "`email` = ?"), append(args, *v)
+	}
+	if v := update.Nickname; v != nil {
+		set, args = append(set, "`nickname` = ?"), append(args, *v)
+	}
+	if v := update.AvatarURL; v != nil {
+		set, args = append(set, "`avatar_url` = ?"), append(args, *v)
+	}
+	if v := update.PasswordHash; v != nil {
+		set, args = append(set, "`password_hash` = ?"), append(args, *v)
+	}
+	if v := update.Description; v != nil {
+		set, args = append(set, "`description` = ?"), append(args, *v)
+	}
+	if v := update.Role; v != nil {
+		set, args = append(set, "`role` = ?"), append(args, *v)
+	}
+	args = append(args, update.ID)
+
+	query := "UPDATE `user` SET " + strings.Join(set, ", ") + " WHERE `id` = ?"
+	if _, err := d.db.ExecContext(ctx, query, args...); err != nil {
+		return nil, err
+	}
+
+	user, err := d.GetUser(ctx, &store.FindUser{ID: &update.ID})
+	if err != nil {
+		return nil, err
+	}
+	return user, nil
+}
+
+func (d *DB) ListUsers(ctx context.Context, find *store.FindUser) ([]*store.User, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if len(find.Filters) > 0 {
+		return nil, errors.Errorf("user filters are not supported")
+	}
+
+	if v := find.ID; v != nil {
+		where, args = append(where, "`id` = ?"), append(args, *v)
+	}
+	if v := find.Username; v != nil {
+		where, args = append(where, "`username` = ?"), append(args, *v)
+	}
+	if v := find.Role; v != nil {
+		where, args = append(where, "`role` = ?"), append(args, *v)
+	}
+	if v := find.Email; v != nil {
+		where, args = append(where, "`email` = ?"), append(args, *v)
+	}
+	if v := find.Nickname; v != nil {
+		where, args = append(where, "`nickname` = ?"), append(args, *v)
+	}
+
+	orderBy := []string{"`created_ts` DESC", "`row_status` DESC"}
+	query := "SELECT `id`, `username`, `role`, `email`, `nickname`, `password_hash`, `avatar_url`, `description`, UNIX_TIMESTAMP(`created_ts`), UNIX_TIMESTAMP(`updated_ts`), `row_status` FROM `user` WHERE " + strings.Join(where, " AND ") + " ORDER BY " + strings.Join(orderBy, ", ")
+	if v := find.Limit; v != nil {
+		query += fmt.Sprintf(" LIMIT %d", *v)
+	}
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := make([]*store.User, 0)
+	for rows.Next() {
+		var user store.User
+		if err := rows.Scan(
+			&user.ID,
+			&user.Username,
+			&user.Role,
+			&user.Email,
+			&user.Nickname,
+			&user.PasswordHash,
+			&user.AvatarURL,
+			&user.Description,
+			&user.CreatedTs,
+			&user.UpdatedTs,
+			&user.RowStatus,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, &user)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) GetUser(ctx context.Context, find *store.FindUser) (*store.User, error) {
+	list, err := d.ListUsers(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+	if len(list) != 1 {
+		return nil, errors.Errorf("unexpected user count: %d", len(list))
+	}
+	return list[0], nil
+}
+
+func (d *DB) DeleteUser(ctx context.Context, delete *store.DeleteUser) error {
+	result, err := d.db.ExecContext(ctx, "DELETE FROM `user` WHERE `id` = ?", delete.ID)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/mysql/user_setting.go

@@ -0,0 +1,93 @@
+package mysql
+
+import (
+	"context"
+	"strings"
+
+	"github.com/pkg/errors"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertUserSetting(ctx context.Context, upsert *store.UserSetting) (*store.UserSetting, error) {
+	stmt := "INSERT INTO `user_setting` (`user_id`, `key`, `value`) VALUES (?, ?, ?) ON DUPLICATE KEY UPDATE `value` = ?"
+	if _, err := d.db.ExecContext(ctx, stmt, upsert.UserID, upsert.Key.String(), upsert.Value, upsert.Value); err != nil {
+		return nil, err
+	}
+	return upsert, nil
+}
+
+func (d *DB) ListUserSettings(ctx context.Context, find *store.FindUserSetting) ([]*store.UserSetting, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if v := find.Key; v != storepb.UserSetting_KEY_UNSPECIFIED {
+		where, args = append(where, "`key` = ?"), append(args, v.String())
+	}
+	if v := find.UserID; v != nil {
+		where, args = append(where, "`user_id` = ?"), append(args, *find.UserID)
+	}
+
+	query := "SELECT `user_id`, `key`, `value` FROM `user_setting` WHERE " + strings.Join(where, " AND ")
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	userSettingList := make([]*store.UserSetting, 0)
+	for rows.Next() {
+		userSetting := &store.UserSetting{}
+		var keyString string
+		if err := rows.Scan(
+			&userSetting.UserID,
+			&keyString,
+			&userSetting.Value,
+		); err != nil {
+			return nil, err
+		}
+		userSetting.Key = storepb.UserSetting_Key(storepb.UserSetting_Key_value[keyString])
+		userSettingList = append(userSettingList, userSetting)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return userSettingList, nil
+}
+
+func (d *DB) GetUserByPATHash(ctx context.Context, tokenHash string) (*store.PATQueryResult, error) {
+	query := `
+		SELECT
+			user_id,
+			value
+		FROM user_setting
+		WHERE ` + "`key`" + ` = 'PERSONAL_ACCESS_TOKENS'
+		  AND JSON_SEARCH(value, 'one', ?, NULL, '$.tokens[*].tokenHash') IS NOT NULL
+	`
+
+	var userID int32
+	var tokensJSON string
+
+	err := d.db.QueryRowContext(ctx, query, tokenHash).Scan(&userID, &tokensJSON)
+	if err != nil {
+		return nil, err
+	}
+
+	patsUserSetting := &storepb.PersonalAccessTokensUserSetting{}
+	if err := protojsonUnmarshaler.Unmarshal([]byte(tokensJSON), patsUserSetting); err != nil {
+		return nil, err
+	}
+
+	for _, pat := range patsUserSetting.Tokens {
+		if pat.TokenHash == tokenHash {
+			return &store.PATQueryResult{
+				UserID: userID,
+				PAT:    pat,
+			}, nil
+		}
+	}
+
+	return nil, errors.New("PAT not found")
+}

store/db/postgres/activity.go

@@ -0,0 +1,81 @@
+package postgres
+
+import (
+	"context"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateActivity(ctx context.Context, create *store.Activity) (*store.Activity, error) {
+	payloadString := "{}"
+	if create.Payload != nil {
+		bytes, err := protojson.Marshal(create.Payload)
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to marshal activity payload")
+		}
+		payloadString = string(bytes)
+	}
+
+	fields := []string{"creator_id", "type", "level", "payload"}
+	args := []any{create.CreatorID, create.Type.String(), create.Level.String(), payloadString}
+	stmt := "INSERT INTO activity (" + strings.Join(fields, ", ") + ") VALUES (" + placeholders(len(args)) + ") RETURNING id, created_ts"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&create.ID,
+		&create.CreatedTs,
+	); err != nil {
+		return nil, err
+	}
+
+	return create, nil
+}
+
+func (d *DB) ListActivities(ctx context.Context, find *store.FindActivity) ([]*store.Activity, error) {
+	where, args := []string{"1 = 1"}, []any{}
+	if find.ID != nil {
+		where, args = append(where, "id = "+placeholder(len(args)+1)), append(args, *find.ID)
+	}
+	if find.Type != nil {
+		where, args = append(where, "type = "+placeholder(len(args)+1)), append(args, find.Type.String())
+	}
+
+	query := "SELECT id, creator_id, type, level, payload, created_ts FROM activity WHERE " + strings.Join(where, " AND ") + " ORDER BY created_ts DESC"
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.Activity{}
+	for rows.Next() {
+		activity := &store.Activity{}
+		var payloadBytes []byte
+		if err := rows.Scan(
+			&activity.ID,
+			&activity.CreatorID,
+			&activity.Type,
+			&activity.Level,
+			&payloadBytes,
+			&activity.CreatedTs,
+		); err != nil {
+			return nil, err
+		}
+
+		payload := &storepb.ActivityPayload{}
+		if err := protojsonUnmarshaler.Unmarshal(payloadBytes, payload); err != nil {
+			return nil, err
+		}
+		activity.Payload = payload
+		list = append(list, activity)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}

store/db/postgres/attachment.go

@@ -0,0 +1,221 @@
+package postgres
+
+import (
+	"context"
+	"database/sql"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	"github.com/usememos/memos/plugin/filter"
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateAttachment(ctx context.Context, create *store.Attachment) (*store.Attachment, error) {
+	fields := []string{"uid", "filename", "blob", "type", "size", "creator_id", "memo_id", "storage_type", "reference", "payload"}
+	storageType := ""
+	if create.StorageType != storepb.AttachmentStorageType_ATTACHMENT_STORAGE_TYPE_UNSPECIFIED {
+		storageType = create.StorageType.String()
+	}
+	payloadString := "{}"
+	if create.Payload != nil {
+		bytes, err := protojson.Marshal(create.Payload)
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to marshal attachment payload")
+		}
+		payloadString = string(bytes)
+	}
+	args := []any{create.UID, create.Filename, create.Blob, create.Type, create.Size, create.CreatorID, create.MemoID, storageType, create.Reference, payloadString}
+
+	stmt := "INSERT INTO attachment (" + strings.Join(fields, ", ") + ") VALUES (" + placeholders(len(args)) + ") RETURNING id, created_ts, updated_ts"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(&create.ID, &create.CreatedTs, &create.UpdatedTs); err != nil {
+		return nil, err
+	}
+	return create, nil
+}
+
+func (d *DB) ListAttachments(ctx context.Context, find *store.FindAttachment) ([]*store.Attachment, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if v := find.ID; v != nil {
+		where, args = append(where, "attachment.id = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := find.UID; v != nil {
+		where, args = append(where, "attachment.uid = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := find.CreatorID; v != nil {
+		where, args = append(where, "attachment.creator_id = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := find.Filename; v != nil {
+		where, args = append(where, "attachment.filename = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := find.FilenameSearch; v != nil {
+		where, args = append(where, "attachment.filename LIKE "+placeholder(len(args)+1)), append(args, fmt.Sprintf("%%%s%%", *v))
+	}
+	if v := find.MemoID; v != nil {
+		where, args = append(where, "attachment.memo_id = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if len(find.MemoIDList) > 0 {
+		holders := make([]string, 0, len(find.MemoIDList))
+		for _, id := range find.MemoIDList {
+			holders = append(holders, placeholder(len(args)+1))
+			args = append(args, id)
+		}
+		where = append(where, "attachment.memo_id IN ("+strings.Join(holders, ", ")+")")
+	}
+	if find.HasRelatedMemo {
+		where = append(where, "attachment.memo_id IS NOT NULL")
+	}
+	if v := find.StorageType; v != nil {
+		where, args = append(where, "attachment.storage_type = "+placeholder(len(args)+1)), append(args, v.String())
+	}
+
+	if len(find.Filters) > 0 {
+		engine, err := filter.DefaultAttachmentEngine()
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to get filter engine")
+		}
+		if err := filter.AppendConditions(ctx, engine, find.Filters, filter.DialectPostgres, &where, &args); err != nil {
+			return nil, errors.Wrap(err, "failed to append filter conditions")
+		}
+	}
+
+	fields := []string{
+		"attachment.id AS id",
+		"attachment.uid AS uid",
+		"attachment.filename AS filename",
+		"attachment.type AS type",
+		"attachment.size AS size",
+		"attachment.creator_id AS creator_id",
+		"attachment.created_ts AS created_ts",
+		"attachment.updated_ts AS updated_ts",
+		"attachment.memo_id AS memo_id",
+		"attachment.storage_type AS storage_type",
+		"attachment.reference AS reference",
+		"attachment.payload AS payload",
+		"CASE WHEN memo.uid IS NOT NULL THEN memo.uid ELSE NULL END AS memo_uid",
+	}
+	if find.GetBlob {
+		fields = append(fields, "attachment.blob AS blob")
+	}
+
+	query := fmt.Sprintf(`
+		SELECT
+			%s
+		FROM attachment
+		LEFT JOIN memo ON attachment.memo_id = memo.id
+		WHERE %s
+		ORDER BY attachment.updated_ts DESC
+	`, strings.Join(fields, ", "), strings.Join(where, " AND "))
+	if find.Limit != nil {
+		query = fmt.Sprintf("%s LIMIT %d", query, *find.Limit)
+		if find.Offset != nil {
+			query = fmt.Sprintf("%s OFFSET %d", query, *find.Offset)
+		}
+	}
+
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := make([]*store.Attachment, 0)
+	for rows.Next() {
+		attachment := store.Attachment{}
+		var memoID sql.NullInt32
+		var storageType string
+		var payloadBytes []byte
+		dests := []any{
+			&attachment.ID,
+			&attachment.UID,
+			&attachment.Filename,
+			&attachment.Type,
+			&attachment.Size,
+			&attachment.CreatorID,
+			&attachment.CreatedTs,
+			&attachment.UpdatedTs,
+			&memoID,
+			&storageType,
+			&attachment.Reference,
+			&payloadBytes,
+			&attachment.MemoUID,
+		}
+		if find.GetBlob {
+			dests = append(dests, &attachment.Blob)
+		}
+		if err := rows.Scan(dests...); err != nil {
+			return nil, err
+		}
+
+		if memoID.Valid {
+			attachment.MemoID = &memoID.Int32
+		}
+		attachment.StorageType = storepb.AttachmentStorageType(storepb.AttachmentStorageType_value[storageType])
+		payload := &storepb.AttachmentPayload{}
+		if err := protojsonUnmarshaler.Unmarshal(payloadBytes, payload); err != nil {
+			return nil, err
+		}
+		attachment.Payload = payload
+		list = append(list, &attachment)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) UpdateAttachment(ctx context.Context, update *store.UpdateAttachment) error {
+	set, args := []string{}, []any{}
+
+	if v := update.UID; v != nil {
+		set, args = append(set, "uid = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.UpdatedTs; v != nil {
+		set, args = append(set, "updated_ts = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Filename; v != nil {
+		set, args = append(set, "filename = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.MemoID; v != nil {
+		set, args = append(set, "memo_id = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Reference; v != nil {
+		set, args = append(set, "reference = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Payload; v != nil {
+		bytes, err := protojson.Marshal(v)
+		if err != nil {
+			return errors.Wrap(err, "failed to marshal attachment payload")
+		}
+		set, args = append(set, "payload = "+placeholder(len(args)+1)), append(args, string(bytes))
+	}
+
+	stmt := `UPDATE attachment SET ` + strings.Join(set, ", ") + ` WHERE id = ` + placeholder(len(args)+1)
+	args = append(args, update.ID)
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}
+
+func (d *DB) DeleteAttachment(ctx context.Context, delete *store.DeleteAttachment) error {
+	stmt := `DELETE FROM attachment WHERE id = $1`
+	result, err := d.db.ExecContext(ctx, stmt, delete.ID)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/postgres/common.go

@@ -0,0 +1,26 @@
+package postgres
+
+import (
+	"fmt"
+	"strings"
+
+	"google.golang.org/protobuf/encoding/protojson"
+)
+
+var (
+	protojsonUnmarshaler = protojson.UnmarshalOptions{
+		DiscardUnknown: true,
+	}
+)
+
+func placeholder(n int) string {
+	return "$" + fmt.Sprint(n)
+}
+
+func placeholders(n int) string {
+	list := []string{}
+	for i := 0; i < n; i++ {
+		list = append(list, placeholder(i+1))
+	}
+	return strings.Join(list, ", ")
+}

store/db/postgres/idp.go

@@ -0,0 +1,117 @@
+package postgres
+
+import (
+	"context"
+	"strings"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateIdentityProvider(ctx context.Context, create *store.IdentityProvider) (*store.IdentityProvider, error) {
+	fields := []string{"name", "type", "identifier_filter", "config"}
+	args := []any{create.Name, create.Type.String(), create.IdentifierFilter, create.Config}
+	stmt := "INSERT INTO idp (" + strings.Join(fields, ", ") + ") VALUES (" + placeholders(len(args)) + ") RETURNING id"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(&create.ID); err != nil {
+		return nil, err
+	}
+
+	identityProvider := create
+	return identityProvider, nil
+}
+
+func (d *DB) ListIdentityProviders(ctx context.Context, find *store.FindIdentityProvider) ([]*store.IdentityProvider, error) {
+	where, args := []string{"1 = 1"}, []any{}
+	if v := find.ID; v != nil {
+		where, args = append(where, "id = "+placeholder(len(args)+1)), append(args, *v)
+	}
+
+	rows, err := d.db.QueryContext(ctx, `
+		SELECT
+			id,
+			name,
+			type,
+			identifier_filter,
+			config
+		FROM idp
+		WHERE `+strings.Join(where, " AND ")+` ORDER BY id ASC`,
+		args...,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	var identityProviders []*store.IdentityProvider
+	for rows.Next() {
+		var identityProvider store.IdentityProvider
+		var typeString string
+		if err := rows.Scan(
+			&identityProvider.ID,
+			&identityProvider.Name,
+			&typeString,
+			&identityProvider.IdentifierFilter,
+			&identityProvider.Config,
+		); err != nil {
+			return nil, err
+		}
+
+		identityProvider.Type = storepb.IdentityProvider_Type(storepb.IdentityProvider_Type_value[typeString])
+		identityProviders = append(identityProviders, &identityProvider)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return identityProviders, nil
+}
+
+func (d *DB) UpdateIdentityProvider(ctx context.Context, update *store.UpdateIdentityProvider) (*store.IdentityProvider, error) {
+	set, args := []string{}, []any{}
+	if v := update.Name; v != nil {
+		set, args = append(set, "name = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.IdentifierFilter; v != nil {
+		set, args = append(set, "identifier_filter = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Config; v != nil {
+		set, args = append(set, "config = "+placeholder(len(args)+1)), append(args, *v)
+	}
+
+	stmt := `
+		UPDATE idp
+		SET ` + strings.Join(set, ", ") + `
+		WHERE id = ` + placeholder(len(args)+1) + `
+		RETURNING id, name, type, identifier_filter, config
+	`
+	args = append(args, update.ID)
+
+	var identityProvider store.IdentityProvider
+	var typeString string
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&identityProvider.ID,
+		&identityProvider.Name,
+		&typeString,
+		&identityProvider.IdentifierFilter,
+		&identityProvider.Config,
+	); err != nil {
+		return nil, err
+	}
+
+	identityProvider.Type = storepb.IdentityProvider_Type(storepb.IdentityProvider_Type_value[typeString])
+	return &identityProvider, nil
+}
+
+func (d *DB) DeleteIdentityProvider(ctx context.Context, delete *store.DeleteIdentityProvider) error {
+	where, args := []string{"id = $1"}, []any{delete.ID}
+	stmt := `DELETE FROM idp WHERE ` + strings.Join(where, " AND ")
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return err
+	}
+	if _, err = result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/postgres/inbox.go

@@ -0,0 +1,151 @@
+package postgres
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateInbox(ctx context.Context, create *store.Inbox) (*store.Inbox, error) {
+	messageString := "{}"
+	if create.Message != nil {
+		bytes, err := protojson.Marshal(create.Message)
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to marshal inbox message")
+		}
+		messageString = string(bytes)
+	}
+
+	fields := []string{"sender_id", "receiver_id", "status", "message"}
+	args := []any{create.SenderID, create.ReceiverID, create.Status, messageString}
+	stmt := "INSERT INTO inbox (" + strings.Join(fields, ", ") + ") VALUES (" + placeholders(len(args)) + ") RETURNING id, created_ts"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&create.ID,
+		&create.CreatedTs,
+	); err != nil {
+		return nil, err
+	}
+
+	return create, nil
+}
+
+func (d *DB) ListInboxes(ctx context.Context, find *store.FindInbox) ([]*store.Inbox, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if find.ID != nil {
+		where, args = append(where, "id = "+placeholder(len(args)+1)), append(args, *find.ID)
+	}
+	if find.SenderID != nil {
+		where, args = append(where, "sender_id = "+placeholder(len(args)+1)), append(args, *find.SenderID)
+	}
+	if find.ReceiverID != nil {
+		where, args = append(where, "receiver_id = "+placeholder(len(args)+1)), append(args, *find.ReceiverID)
+	}
+	if find.Status != nil {
+		where, args = append(where, "status = "+placeholder(len(args)+1)), append(args, *find.Status)
+	}
+	if find.MessageType != nil {
+		// Filter by message type using PostgreSQL JSON extraction
+		// Note: The type field in JSON is stored as string representation of the enum name
+		// Cast to JSONB since the column is TEXT
+		if *find.MessageType == storepb.InboxMessage_TYPE_UNSPECIFIED {
+			where, args = append(where, "(message::JSONB->>'type' IS NULL OR message::JSONB->>'type' = "+placeholder(len(args)+1)+")"), append(args, find.MessageType.String())
+		} else {
+			where, args = append(where, "message::JSONB->>'type' = "+placeholder(len(args)+1)), append(args, find.MessageType.String())
+		}
+	}
+
+	query := "SELECT id, created_ts, sender_id, receiver_id, status, message FROM inbox WHERE " + strings.Join(where, " AND ") + " ORDER BY created_ts DESC"
+	if find.Limit != nil {
+		query = fmt.Sprintf("%s LIMIT %d", query, *find.Limit)
+		if find.Offset != nil {
+			query = fmt.Sprintf("%s OFFSET %d", query, *find.Offset)
+		}
+	}
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.Inbox{}
+	for rows.Next() {
+		inbox := &store.Inbox{}
+		var messageBytes []byte
+		if err := rows.Scan(
+			&inbox.ID,
+			&inbox.CreatedTs,
+			&inbox.SenderID,
+			&inbox.ReceiverID,
+			&inbox.Status,
+			&messageBytes,
+		); err != nil {
+			return nil, err
+		}
+
+		message := &storepb.InboxMessage{}
+		if err := protojsonUnmarshaler.Unmarshal(messageBytes, message); err != nil {
+			return nil, err
+		}
+		inbox.Message = message
+		list = append(list, inbox)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) GetInbox(ctx context.Context, find *store.FindInbox) (*store.Inbox, error) {
+	list, err := d.ListInboxes(ctx, find)
+	if err != nil {
+		return nil, errors.Wrap(err, "failed to get inbox")
+	}
+	if len(list) != 1 {
+		return nil, errors.Errorf("unexpected inbox count: %d", len(list))
+	}
+	return list[0], nil
+}
+
+func (d *DB) UpdateInbox(ctx context.Context, update *store.UpdateInbox) (*store.Inbox, error) {
+	set, args := []string{"status = $1"}, []any{update.Status.String()}
+	args = append(args, update.ID)
+	query := "UPDATE inbox SET " + strings.Join(set, ", ") + " WHERE id = $2 RETURNING id, created_ts, sender_id, receiver_id, status, message"
+	inbox := &store.Inbox{}
+	var messageBytes []byte
+	if err := d.db.QueryRowContext(ctx, query, args...).Scan(
+		&inbox.ID,
+		&inbox.CreatedTs,
+		&inbox.SenderID,
+		&inbox.ReceiverID,
+		&inbox.Status,
+		&messageBytes,
+	); err != nil {
+		return nil, err
+	}
+	message := &storepb.InboxMessage{}
+	if err := protojsonUnmarshaler.Unmarshal(messageBytes, message); err != nil {
+		return nil, err
+	}
+	inbox.Message = message
+	return inbox, nil
+}
+
+func (d *DB) DeleteInbox(ctx context.Context, delete *store.DeleteInbox) error {
+	result, err := d.db.ExecContext(ctx, "DELETE FROM inbox WHERE id = $1", delete.ID)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/postgres/instance_setting.go

@@ -0,0 +1,72 @@
+package postgres
+
+import (
+	"context"
+	"strings"
+
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertInstanceSetting(ctx context.Context, upsert *store.InstanceSetting) (*store.InstanceSetting, error) {
+	stmt := `
+		INSERT INTO system_setting (
+			name, value, description
+		)
+		VALUES ($1, $2, $3)
+		ON CONFLICT(name) DO UPDATE
+		SET
+			value = EXCLUDED.value,
+			description = EXCLUDED.description
+	`
+	if _, err := d.db.ExecContext(ctx, stmt, upsert.Name, upsert.Value, upsert.Description); err != nil {
+		return nil, err
+	}
+
+	return upsert, nil
+}
+
+func (d *DB) ListInstanceSettings(ctx context.Context, find *store.FindInstanceSetting) ([]*store.InstanceSetting, error) {
+	where, args := []string{"1 = 1"}, []any{}
+	if find.Name != "" {
+		where, args = append(where, "name = "+placeholder(len(args)+1)), append(args, find.Name)
+	}
+
+	query := `
+		SELECT
+			name,
+			value,
+			description
+		FROM system_setting
+		WHERE ` + strings.Join(where, " AND ")
+
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.InstanceSetting{}
+	for rows.Next() {
+		systemSettingMessage := &store.InstanceSetting{}
+		if err := rows.Scan(
+			&systemSettingMessage.Name,
+			&systemSettingMessage.Value,
+			&systemSettingMessage.Description,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, systemSettingMessage)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) DeleteInstanceSetting(ctx context.Context, delete *store.DeleteInstanceSetting) error {
+	stmt := `DELETE FROM system_setting WHERE name = $1`
+	_, err := d.db.ExecContext(ctx, stmt, delete.Name)
+	return err
+}

store/db/postgres/memo.go

@@ -0,0 +1,254 @@
+package postgres
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	"github.com/usememos/memos/plugin/filter"
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateMemo(ctx context.Context, create *store.Memo) (*store.Memo, error) {
+	fields := []string{"uid", "creator_id", "content", "visibility", "payload"}
+	payload := "{}"
+	if create.Payload != nil {
+		payloadBytes, err := protojson.Marshal(create.Payload)
+		if err != nil {
+			return nil, err
+		}
+		payload = string(payloadBytes)
+	}
+	args := []any{create.UID, create.CreatorID, create.Content, create.Visibility, payload}
+
+	// Add custom timestamps if provided
+	if create.CreatedTs != 0 {
+		fields = append(fields, "created_ts")
+		args = append(args, create.CreatedTs)
+	}
+	if create.UpdatedTs != 0 {
+		fields = append(fields, "updated_ts")
+		args = append(args, create.UpdatedTs)
+	}
+
+	stmt := "INSERT INTO memo (" + strings.Join(fields, ", ") + ") VALUES (" + placeholders(len(args)) + ") RETURNING id, created_ts, updated_ts, row_status"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&create.ID,
+		&create.CreatedTs,
+		&create.UpdatedTs,
+		&create.RowStatus,
+	); err != nil {
+		return nil, err
+	}
+
+	return create, nil
+}
+
+func (d *DB) ListMemos(ctx context.Context, find *store.FindMemo) ([]*store.Memo, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	engine, err := filter.DefaultEngine()
+	if err != nil {
+		return nil, err
+	}
+	if err := filter.AppendConditions(ctx, engine, find.Filters, filter.DialectPostgres, &where, &args); err != nil {
+		return nil, err
+	}
+	if v := find.ID; v != nil {
+		where, args = append(where, "memo.id = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if len(find.IDList) > 0 {
+		holders := make([]string, 0, len(find.IDList))
+		for _, id := range find.IDList {
+			holders = append(holders, placeholder(len(args)+1))
+			args = append(args, id)
+		}
+		where = append(where, "memo.id IN ("+strings.Join(holders, ", ")+")")
+	}
+	if v := find.UID; v != nil {
+		where, args = append(where, "memo.uid = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if len(find.UIDList) > 0 {
+		holders := make([]string, 0, len(find.UIDList))
+		for _, uid := range find.UIDList {
+			holders = append(holders, placeholder(len(args)+1))
+			args = append(args, uid)
+		}
+		where = append(where, "memo.uid IN ("+strings.Join(holders, ", ")+")")
+	}
+	if v := find.CreatorID; v != nil {
+		where, args = append(where, "memo.creator_id = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := find.RowStatus; v != nil {
+		where, args = append(where, "memo.row_status = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := find.VisibilityList; len(v) != 0 {
+		holders := []string{}
+		for _, visibility := range v {
+			holders = append(holders, placeholder(len(args)+1))
+			args = append(args, visibility.String())
+		}
+		where = append(where, fmt.Sprintf("memo.visibility in (%s)", strings.Join(holders, ", ")))
+	}
+	if find.ExcludeComments {
+		where = append(where, "memo_relation.related_memo_id IS NULL")
+	}
+
+	order := "DESC"
+	if find.OrderByTimeAsc {
+		order = "ASC"
+	}
+	orderBy := []string{}
+	if find.OrderByPinned {
+		orderBy = append(orderBy, "pinned DESC")
+	}
+	if find.OrderByUpdatedTs {
+		orderBy = append(orderBy, "updated_ts "+order)
+	} else {
+		orderBy = append(orderBy, "created_ts "+order)
+	}
+	// Add id as final tie-breaker
+	orderBy = append(orderBy, "id DESC")
+	fields := []string{
+		`memo.id AS id`,
+		`memo.uid AS uid`,
+		`memo.creator_id AS creator_id`,
+		`memo.created_ts AS created_ts`,
+		`memo.updated_ts AS updated_ts`,
+		`memo.row_status AS row_status`,
+		`memo.visibility AS visibility`,
+		`memo.pinned AS pinned`,
+		`memo.payload AS payload`,
+		`CASE WHEN parent_memo.uid IS NOT NULL THEN parent_memo.uid ELSE NULL END AS parent_uid`,
+	}
+	if !find.ExcludeContent {
+		fields = append(fields, `memo.content AS content`)
+	}
+
+	query := `SELECT ` + strings.Join(fields, ", ") + `
+		FROM memo
+		LEFT JOIN memo_relation ON memo.id = memo_relation.memo_id AND memo_relation.type = 'COMMENT'
+		LEFT JOIN memo AS parent_memo ON memo_relation.related_memo_id = parent_memo.id
+		WHERE ` + strings.Join(where, " AND ") + `
+		ORDER BY ` + strings.Join(orderBy, ", ")
+	if find.Limit != nil {
+		query = fmt.Sprintf("%s LIMIT %d", query, *find.Limit)
+		if find.Offset != nil {
+			query = fmt.Sprintf("%s OFFSET %d", query, *find.Offset)
+		}
+	}
+
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := make([]*store.Memo, 0)
+	for rows.Next() {
+		var memo store.Memo
+		var payloadBytes []byte
+		dests := []any{
+			&memo.ID,
+			&memo.UID,
+			&memo.CreatorID,
+			&memo.CreatedTs,
+			&memo.UpdatedTs,
+			&memo.RowStatus,
+			&memo.Visibility,
+			&memo.Pinned,
+			&payloadBytes,
+			&memo.ParentUID,
+		}
+		if !find.ExcludeContent {
+			dests = append(dests, &memo.Content)
+		}
+		if err := rows.Scan(dests...); err != nil {
+			return nil, err
+		}
+		payload := &storepb.MemoPayload{}
+		if err := protojsonUnmarshaler.Unmarshal(payloadBytes, payload); err != nil {
+			return nil, errors.Wrap(err, "failed to unmarshal payload")
+		}
+		memo.Payload = payload
+		list = append(list, &memo)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) GetMemo(ctx context.Context, find *store.FindMemo) (*store.Memo, error) {
+	list, err := d.ListMemos(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+	if len(list) == 0 {
+		return nil, nil
+	}
+
+	memo := list[0]
+	return memo, nil
+}
+
+func (d *DB) UpdateMemo(ctx context.Context, update *store.UpdateMemo) error {
+	set, args := []string{}, []any{}
+	if v := update.UID; v != nil {
+		set, args = append(set, "uid = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.CreatedTs; v != nil {
+		set, args = append(set, "created_ts = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.UpdatedTs; v != nil {
+		set, args = append(set, "updated_ts = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.RowStatus; v != nil {
+		set, args = append(set, "row_status = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Content; v != nil {
+		set, args = append(set, "content = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Visibility; v != nil {
+		set, args = append(set, "visibility = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Pinned; v != nil {
+		set, args = append(set, "pinned = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Payload; v != nil {
+		payloadBytes, err := protojson.Marshal(v)
+		if err != nil {
+			return err
+		}
+		set, args = append(set, "payload = "+placeholder(len(args)+1)), append(args, string(payloadBytes))
+	}
+	if len(set) == 0 {
+		return nil
+	}
+
+	stmt := `UPDATE memo SET ` + strings.Join(set, ", ") + ` WHERE id = ` + placeholder(len(args)+1)
+	args = append(args, update.ID)
+	if _, err := d.db.ExecContext(ctx, stmt, args...); err != nil {
+		return err
+	}
+	return nil
+}
+
+func (d *DB) DeleteMemo(ctx context.Context, delete *store.DeleteMemo) error {
+	where, args := []string{"id = " + placeholder(1)}, []any{delete.ID}
+	stmt := `DELETE FROM memo WHERE ` + strings.Join(where, " AND ")
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return errors.Wrap(err, "failed to delete memo")
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/postgres/memo_relation.go

@@ -0,0 +1,134 @@
+package postgres
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/usememos/memos/plugin/filter"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertMemoRelation(ctx context.Context, create *store.MemoRelation) (*store.MemoRelation, error) {
+	stmt := `
+		INSERT INTO memo_relation (
+			memo_id,
+			related_memo_id,
+			type
+		)
+		VALUES (` + placeholders(3) + `)
+		ON CONFLICT (memo_id, related_memo_id, type) DO UPDATE SET type = EXCLUDED.type
+		RETURNING memo_id, related_memo_id, type
+	`
+	memoRelation := &store.MemoRelation{}
+	if err := d.db.QueryRowContext(
+		ctx,
+		stmt,
+		create.MemoID,
+		create.RelatedMemoID,
+		create.Type,
+	).Scan(
+		&memoRelation.MemoID,
+		&memoRelation.RelatedMemoID,
+		&memoRelation.Type,
+	); err != nil {
+		return nil, err
+	}
+
+	return memoRelation, nil
+}
+
+func (d *DB) ListMemoRelations(ctx context.Context, find *store.FindMemoRelation) ([]*store.MemoRelation, error) {
+	where, args := []string{"1 = 1"}, []any{}
+	if find.MemoID != nil {
+		where, args = append(where, "memo_id = "+placeholder(len(args)+1)), append(args, find.MemoID)
+	}
+	if find.RelatedMemoID != nil {
+		where, args = append(where, "related_memo_id = "+placeholder(len(args)+1)), append(args, find.RelatedMemoID)
+	}
+	if find.Type != nil {
+		where, args = append(where, "type = "+placeholder(len(args)+1)), append(args, find.Type)
+	}
+	if find.MemoFilter != nil {
+		engine, err := filter.DefaultEngine()
+		if err != nil {
+			return nil, err
+		}
+		stmt, err := engine.CompileToStatement(ctx, *find.MemoFilter, filter.RenderOptions{
+			Dialect:           filter.DialectPostgres,
+			PlaceholderOffset: len(args),
+		})
+		if err != nil {
+			return nil, err
+		}
+		if stmt.SQL != "" {
+			where = append(where, fmt.Sprintf("memo_id IN (SELECT id FROM memo WHERE %s)", stmt.SQL))
+			args = append(args, stmt.Args...)
+
+			stmtRelated, err := engine.CompileToStatement(ctx, *find.MemoFilter, filter.RenderOptions{
+				Dialect:           filter.DialectPostgres,
+				PlaceholderOffset: len(args),
+			})
+			if err != nil {
+				return nil, err
+			}
+			if stmtRelated.SQL != "" {
+				where = append(where, fmt.Sprintf("related_memo_id IN (SELECT id FROM memo WHERE %s)", stmtRelated.SQL))
+				args = append(args, stmtRelated.Args...)
+			}
+		}
+	}
+
+	rows, err := d.db.QueryContext(ctx, `
+		SELECT
+			memo_id,
+			related_memo_id,
+			type
+		FROM memo_relation
+		WHERE `+strings.Join(where, " AND "), args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.MemoRelation{}
+	for rows.Next() {
+		memoRelation := &store.MemoRelation{}
+		if err := rows.Scan(
+			&memoRelation.MemoID,
+			&memoRelation.RelatedMemoID,
+			&memoRelation.Type,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, memoRelation)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) DeleteMemoRelation(ctx context.Context, delete *store.DeleteMemoRelation) error {
+	where, args := []string{"1 = 1"}, []any{}
+	if delete.MemoID != nil {
+		where, args = append(where, "memo_id = "+placeholder(len(args)+1)), append(args, delete.MemoID)
+	}
+	if delete.RelatedMemoID != nil {
+		where, args = append(where, "related_memo_id = "+placeholder(len(args)+1)), append(args, delete.RelatedMemoID)
+	}
+	if delete.Type != nil {
+		where, args = append(where, "type = "+placeholder(len(args)+1)), append(args, delete.Type)
+	}
+	stmt := `DELETE FROM memo_relation WHERE ` + strings.Join(where, " AND ")
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return err
+	}
+	if _, err = result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/postgres/postgres.go

@@ -0,0 +1,57 @@
+package postgres
+
+import (
+	"context"
+	"database/sql"
+	"log"
+
+	// Import the PostgreSQL driver.
+	_ "github.com/lib/pq"
+	"github.com/pkg/errors"
+
+	"github.com/usememos/memos/internal/profile"
+	"github.com/usememos/memos/store"
+)
+
+type DB struct {
+	db      *sql.DB
+	profile *profile.Profile
+}
+
+func NewDB(profile *profile.Profile) (store.Driver, error) {
+	if profile == nil {
+		return nil, errors.New("profile is nil")
+	}
+
+	// Open the PostgreSQL connection
+	db, err := sql.Open("postgres", profile.DSN)
+	if err != nil {
+		log.Printf("Failed to open database: %s", err)
+		return nil, errors.Wrapf(err, "failed to open database: %s", profile.DSN)
+	}
+
+	var driver store.Driver = &DB{
+		db:      db,
+		profile: profile,
+	}
+
+	// Return the DB struct
+	return driver, nil
+}
+
+func (d *DB) GetDB() *sql.DB {
+	return d.db
+}
+
+func (d *DB) Close() error {
+	return d.db.Close()
+}
+
+func (d *DB) IsInitialized(ctx context.Context) (bool, error) {
+	var exists bool
+	err := d.db.QueryRowContext(ctx, "SELECT EXISTS (SELECT 1 FROM information_schema.tables WHERE table_catalog = current_database() AND table_name = 'memo' AND table_type = 'BASE TABLE')").Scan(&exists)
+	if err != nil {
+		return false, errors.Wrap(err, "failed to check if database is initialized")
+	}
+	return exists, nil
+}

store/db/postgres/reaction.go

@@ -0,0 +1,101 @@
+package postgres
+
+import (
+	"context"
+	"strings"
+
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertReaction(ctx context.Context, upsert *store.Reaction) (*store.Reaction, error) {
+	fields := []string{"creator_id", "content_id", "reaction_type"}
+	args := []interface{}{upsert.CreatorID, upsert.ContentID, upsert.ReactionType}
+	stmt := "INSERT INTO reaction (" + strings.Join(fields, ", ") + ") VALUES (" + placeholders(len(args)) + ") RETURNING id, created_ts"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&upsert.ID,
+		&upsert.CreatedTs,
+	); err != nil {
+		return nil, err
+	}
+
+	reaction := upsert
+	return reaction, nil
+}
+
+func (d *DB) ListReactions(ctx context.Context, find *store.FindReaction) ([]*store.Reaction, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if find.ID != nil {
+		where, args = append(where, "id = "+placeholder(len(args)+1)), append(args, *find.ID)
+	}
+	if find.CreatorID != nil {
+		where, args = append(where, "creator_id = "+placeholder(len(args)+1)), append(args, *find.CreatorID)
+	}
+	if find.ContentID != nil {
+		where, args = append(where, "content_id = "+placeholder(len(args)+1)), append(args, *find.ContentID)
+	}
+	if len(find.ContentIDList) > 0 {
+		holders := make([]string, 0, len(find.ContentIDList))
+		for _, id := range find.ContentIDList {
+			holders = append(holders, placeholder(len(args)+1))
+			args = append(args, id)
+		}
+		where = append(where, "content_id IN ("+strings.Join(holders, ", ")+")")
+	}
+
+	rows, err := d.db.QueryContext(ctx, `
+		SELECT
+			id,
+			created_ts,
+			creator_id,
+			content_id,
+			reaction_type
+		FROM reaction
+		WHERE `+strings.Join(where, " AND ")+`
+		ORDER BY id ASC`,
+		args...,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.Reaction{}
+	for rows.Next() {
+		reaction := &store.Reaction{}
+		if err := rows.Scan(
+			&reaction.ID,
+			&reaction.CreatedTs,
+			&reaction.CreatorID,
+			&reaction.ContentID,
+			&reaction.ReactionType,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, reaction)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) GetReaction(ctx context.Context, find *store.FindReaction) (*store.Reaction, error) {
+	list, err := d.ListReactions(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+	if len(list) == 0 {
+		return nil, nil
+	}
+
+	reaction := list[0]
+	return reaction, nil
+}
+
+func (d *DB) DeleteReaction(ctx context.Context, delete *store.DeleteReaction) error {
+	_, err := d.db.ExecContext(ctx, "DELETE FROM reaction WHERE id = $1", delete.ID)
+	return err
+}

store/db/postgres/user.go

@@ -0,0 +1,172 @@
+package postgres
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateUser(ctx context.Context, create *store.User) (*store.User, error) {
+	fields := []string{"username", "role", "email", "nickname", "password_hash", "avatar_url"}
+	args := []any{create.Username, create.Role, create.Email, create.Nickname, create.PasswordHash, create.AvatarURL}
+	stmt := "INSERT INTO \"user\" (" + strings.Join(fields, ", ") + ") VALUES (" + placeholders(len(args)) + ") RETURNING id, description, created_ts, updated_ts, row_status"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&create.ID,
+		&create.Description,
+		&create.CreatedTs,
+		&create.UpdatedTs,
+		&create.RowStatus,
+	); err != nil {
+		return nil, err
+	}
+
+	return create, nil
+}
+
+func (d *DB) UpdateUser(ctx context.Context, update *store.UpdateUser) (*store.User, error) {
+	set, args := []string{}, []any{}
+	if v := update.UpdatedTs; v != nil {
+		set, args = append(set, "updated_ts = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.RowStatus; v != nil {
+		set, args = append(set, "row_status = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Username; v != nil {
+		set, args = append(set, "username = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Email; v != nil {
+		set, args = append(set, "email = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Nickname; v != nil {
+		set, args = append(set, "nickname = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.AvatarURL; v != nil {
+		set, args = append(set, "avatar_url = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.PasswordHash; v != nil {
+		set, args = append(set, "password_hash = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Description; v != nil {
+		set, args = append(set, "description = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := update.Role; v != nil {
+		set, args = append(set, "role = "+placeholder(len(args)+1)), append(args, *v)
+	}
+
+	query := `
+		UPDATE "user"
+		SET ` + strings.Join(set, ", ") + `
+		WHERE id = ` + placeholder(len(args)+1) + `
+		RETURNING id, username, role, email, nickname, password_hash, avatar_url, description, created_ts, updated_ts, row_status
+	`
+	args = append(args, update.ID)
+	user := &store.User{}
+	if err := d.db.QueryRowContext(ctx, query, args...).Scan(
+		&user.ID,
+		&user.Username,
+		&user.Role,
+		&user.Email,
+		&user.Nickname,
+		&user.PasswordHash,
+		&user.AvatarURL,
+		&user.Description,
+		&user.CreatedTs,
+		&user.UpdatedTs,
+		&user.RowStatus,
+	); err != nil {
+		return nil, err
+	}
+
+	return user, nil
+}
+
+func (d *DB) ListUsers(ctx context.Context, find *store.FindUser) ([]*store.User, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if len(find.Filters) > 0 {
+		return nil, errors.Errorf("user filters are not supported")
+	}
+
+	if v := find.ID; v != nil {
+		where, args = append(where, "id = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := find.Username; v != nil {
+		where, args = append(where, "username = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := find.Role; v != nil {
+		where, args = append(where, "role = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := find.Email; v != nil {
+		where, args = append(where, "email = "+placeholder(len(args)+1)), append(args, *v)
+	}
+	if v := find.Nickname; v != nil {
+		where, args = append(where, "nickname = "+placeholder(len(args)+1)), append(args, *v)
+	}
+
+	orderBy := []string{"created_ts DESC", "row_status DESC"}
+	query := `
+		SELECT 
+			id,
+			username,
+			role,
+			email,
+			nickname,
+			password_hash,
+			avatar_url,
+			description,
+			created_ts,
+			updated_ts,
+			row_status
+		FROM "user"
+		WHERE ` + strings.Join(where, " AND ") + ` ORDER BY ` + strings.Join(orderBy, ", ")
+	if v := find.Limit; v != nil {
+		query += fmt.Sprintf(" LIMIT %d", *v)
+	}
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := make([]*store.User, 0)
+	for rows.Next() {
+		var user store.User
+		if err := rows.Scan(
+			&user.ID,
+			&user.Username,
+			&user.Role,
+			&user.Email,
+			&user.Nickname,
+			&user.PasswordHash,
+			&user.AvatarURL,
+			&user.Description,
+			&user.CreatedTs,
+			&user.UpdatedTs,
+			&user.RowStatus,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, &user)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) DeleteUser(ctx context.Context, delete *store.DeleteUser) error {
+	result, err := d.db.ExecContext(ctx, `DELETE FROM "user" WHERE id = $1`, delete.ID)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/postgres/user_setting.go

@@ -0,0 +1,121 @@
+package postgres
+
+import (
+	"context"
+	"strings"
+
+	"github.com/pkg/errors"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertUserSetting(ctx context.Context, upsert *store.UserSetting) (*store.UserSetting, error) {
+	stmt := `
+		INSERT INTO user_setting (
+			user_id, key, value
+		)
+		VALUES ($1, $2, $3)
+		ON CONFLICT(user_id, key) DO UPDATE 
+		SET value = EXCLUDED.value
+	`
+	if _, err := d.db.ExecContext(ctx, stmt, upsert.UserID, upsert.Key.String(), upsert.Value); err != nil {
+		return nil, err
+	}
+	return upsert, nil
+}
+
+func (d *DB) ListUserSettings(ctx context.Context, find *store.FindUserSetting) ([]*store.UserSetting, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if v := find.Key; v != storepb.UserSetting_KEY_UNSPECIFIED {
+		where, args = append(where, "key = "+placeholder(len(args)+1)), append(args, v.String())
+	}
+	if v := find.UserID; v != nil {
+		where, args = append(where, "user_id = "+placeholder(len(args)+1)), append(args, *find.UserID)
+	}
+
+	query := `
+		SELECT
+			user_id,
+		  key,
+			value
+		FROM user_setting
+		WHERE ` + strings.Join(where, " AND ")
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	userSettingList := make([]*store.UserSetting, 0)
+	for rows.Next() {
+		userSetting := &store.UserSetting{}
+		var keyString string
+		if err := rows.Scan(
+			&userSetting.UserID,
+			&keyString,
+			&userSetting.Value,
+		); err != nil {
+			return nil, err
+		}
+		userSetting.Key = storepb.UserSetting_Key(storepb.UserSetting_Key_value[keyString])
+		userSettingList = append(userSettingList, userSetting)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return userSettingList, nil
+}
+
+func (d *DB) GetUserByPATHash(ctx context.Context, tokenHash string) (*store.PATQueryResult, error) {
+	// Simplified query: fetch all PERSONAL_ACCESS_TOKENS rows and search in Go
+	// This matches SQLite/MySQL behavior and avoids PostgreSQL's strict JSONB errors
+	query := `
+		SELECT
+			user_id,
+			value
+		FROM user_setting
+		WHERE key = 'PERSONAL_ACCESS_TOKENS'
+	`
+
+	rows, err := d.db.QueryContext(ctx, query)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	// Iterate through all users with PAT settings
+	for rows.Next() {
+		var userID int32
+		var tokensJSON string
+
+		if err := rows.Scan(&userID, &tokensJSON); err != nil {
+			continue // Skip malformed rows
+		}
+
+		// Try to unmarshal - skip if invalid JSON
+		patsUserSetting := &storepb.PersonalAccessTokensUserSetting{}
+		if err := protojsonUnmarshaler.Unmarshal([]byte(tokensJSON), patsUserSetting); err != nil {
+			continue // Skip invalid JSON
+		}
+
+		// Search for matching token hash
+		for _, pat := range patsUserSetting.Tokens {
+			if pat.TokenHash == tokenHash {
+				return &store.PATQueryResult{
+					UserID: userID,
+					PAT:    pat,
+				}, nil
+			}
+		}
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return nil, errors.New("PAT not found")
+}

store/db/postgres/user_setting_test.go

@@ -0,0 +1,290 @@
+package postgres
+
+import (
+	"context"
+	"database/sql"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+// TestGetUserByPATHashWithMissingData tests the fix for #5611 and #5612.
+// Verifies that GetUserByPATHash handles missing/malformed data gracefully
+// instead of throwing PostgreSQL JSONB errors.
+func TestGetUserByPATHashWithMissingData(t *testing.T) {
+	if testing.Short() {
+		t.Skip("Skipping PostgreSQL integration test in short mode")
+	}
+
+	// This test requires a real PostgreSQL connection
+	// If DSN is not provided, skip the test
+	dsn := getTestDSN()
+	if dsn == "" {
+		t.Skip("PostgreSQL DSN not provided, skipping test")
+	}
+
+	db, err := sql.Open("postgres", dsn)
+	require.NoError(t, err)
+	defer db.Close()
+
+	// Create test database
+	ctx := context.Background()
+	driver := &DB{db: db}
+
+	// Setup: Create user_setting table if needed
+	_, err = db.ExecContext(ctx, `
+		CREATE TABLE IF NOT EXISTS user_setting (
+			user_id INTEGER NOT NULL,
+			key TEXT NOT NULL,
+			value TEXT NOT NULL,
+			UNIQUE(user_id, key)
+		)
+	`)
+	require.NoError(t, err)
+
+	// Cleanup
+	defer func() {
+		db.ExecContext(ctx, "DELETE FROM user_setting WHERE user_id IN (1001, 1002, 1003)")
+	}()
+
+	t.Run("NoTokensKeyAtAll", func(t *testing.T) {
+		// Test case: User has no PERSONAL_ACCESS_TOKENS key
+		// This simulates fresh users or users upgraded from v0.25.3
+		result, err := driver.GetUserByPATHash(ctx, "any-hash")
+		assert.Error(t, err)
+		assert.Nil(t, result)
+		assert.Contains(t, err.Error(), "PAT not found")
+	})
+
+	t.Run("EmptyTokensArray", func(t *testing.T) {
+		// Insert user with empty tokens array
+		_, err := db.ExecContext(ctx, `
+			INSERT INTO user_setting (user_id, key, value)
+			VALUES ($1, $2, $3)
+			ON CONFLICT (user_id, key) DO UPDATE SET value = EXCLUDED.value
+		`, 1001, "PERSONAL_ACCESS_TOKENS", `{"tokens":[]}`)
+		require.NoError(t, err)
+
+		result, err := driver.GetUserByPATHash(ctx, "any-hash")
+		assert.Error(t, err)
+		assert.Nil(t, result)
+		assert.Contains(t, err.Error(), "PAT not found")
+	})
+
+	t.Run("MalformedJSON", func(t *testing.T) {
+		// Insert user with malformed JSON
+		_, err := db.ExecContext(ctx, `
+			INSERT INTO user_setting (user_id, key, value)
+			VALUES ($1, $2, $3)
+			ON CONFLICT (user_id, key) DO UPDATE SET value = EXCLUDED.value
+		`, 1002, "PERSONAL_ACCESS_TOKENS", `{invalid json}`)
+		require.NoError(t, err)
+
+		// Should handle gracefully without crashing
+		result, err := driver.GetUserByPATHash(ctx, "any-hash")
+		assert.Error(t, err)
+		assert.Nil(t, result)
+		assert.Contains(t, err.Error(), "PAT not found")
+	})
+
+	t.Run("MissingTokensField", func(t *testing.T) {
+		// Insert user with valid JSON but missing 'tokens' field
+		_, err := db.ExecContext(ctx, `
+			INSERT INTO user_setting (user_id, key, value)
+			VALUES ($1, $2, $3)
+			ON CONFLICT (user_id, key) DO UPDATE SET value = EXCLUDED.value
+		`, 1003, "PERSONAL_ACCESS_TOKENS", `{"someOtherField":"value"}`)
+		require.NoError(t, err)
+
+		// Should handle gracefully
+		result, err := driver.GetUserByPATHash(ctx, "any-hash")
+		assert.Error(t, err)
+		assert.Nil(t, result)
+	})
+
+	t.Run("ValidTokenFound", func(t *testing.T) {
+		// Insert user with valid PAT
+		validJSON := `{
+			"tokens": [
+				{
+					"tokenId": "pat-test",
+					"tokenHash": "hash-test-123",
+					"description": "Test PAT"
+				}
+			]
+		}`
+		_, err := db.ExecContext(ctx, `
+			INSERT INTO user_setting (user_id, key, value)
+			VALUES ($1, $2, $3)
+			ON CONFLICT (user_id, key) DO UPDATE SET value = EXCLUDED.value
+		`, 1001, "PERSONAL_ACCESS_TOKENS", validJSON)
+		require.NoError(t, err)
+
+		// Should find the token
+		result, err := driver.GetUserByPATHash(ctx, "hash-test-123")
+		assert.NoError(t, err)
+		assert.NotNil(t, result)
+		assert.Equal(t, int32(1001), result.UserID)
+		assert.Equal(t, "pat-test", result.PAT.TokenId)
+		assert.Equal(t, "hash-test-123", result.PAT.TokenHash)
+	})
+
+	t.Run("MultipleUsersWithMixedData", func(t *testing.T) {
+		// User 1001: Valid PAT
+		validJSON := `{
+			"tokens": [
+				{
+					"tokenId": "pat-user1",
+					"tokenHash": "hash-user1",
+					"description": "User 1 PAT"
+				}
+			]
+		}`
+		_, err := db.ExecContext(ctx, `
+			INSERT INTO user_setting (user_id, key, value)
+			VALUES ($1, $2, $3)
+			ON CONFLICT (user_id, key) DO UPDATE SET value = EXCLUDED.value
+		`, 1001, "PERSONAL_ACCESS_TOKENS", validJSON)
+		require.NoError(t, err)
+
+		// User 1002: Malformed JSON (should be skipped)
+		_, err = db.ExecContext(ctx, `
+			INSERT INTO user_setting (user_id, key, value)
+			VALUES ($1, $2, $3)
+			ON CONFLICT (user_id, key) DO UPDATE SET value = EXCLUDED.value
+		`, 1002, "PERSONAL_ACCESS_TOKENS", `{invalid}`)
+		require.NoError(t, err)
+
+		// User 1003: Empty array (should be skipped)
+		_, err = db.ExecContext(ctx, `
+			INSERT INTO user_setting (user_id, key, value)
+			VALUES ($1, $2, $3)
+			ON CONFLICT (user_id, key) DO UPDATE SET value = EXCLUDED.value
+		`, 1003, "PERSONAL_ACCESS_TOKENS", `{"tokens":[]}`)
+		require.NoError(t, err)
+
+		// Should still find user 1001's token despite other users having bad data
+		result, err := driver.GetUserByPATHash(ctx, "hash-user1")
+		assert.NoError(t, err)
+		assert.NotNil(t, result)
+		assert.Equal(t, int32(1001), result.UserID)
+	})
+}
+
+// TestGetUserByPATHashPerformance ensures the simplified query doesn't cause performance issues.
+func TestGetUserByPATHashPerformance(t *testing.T) {
+	if testing.Short() {
+		t.Skip("Skipping performance test in short mode")
+	}
+
+	dsn := getTestDSN()
+	if dsn == "" {
+		t.Skip("PostgreSQL DSN not provided, skipping test")
+	}
+
+	db, err := sql.Open("postgres", dsn)
+	require.NoError(t, err)
+	defer db.Close()
+
+	ctx := context.Background()
+	driver := &DB{db: db}
+
+	// Setup table
+	_, err = db.ExecContext(ctx, `
+		CREATE TABLE IF NOT EXISTS user_setting (
+			user_id INTEGER NOT NULL,
+			key TEXT NOT NULL,
+			value TEXT NOT NULL,
+			UNIQUE(user_id, key)
+		)
+	`)
+	require.NoError(t, err)
+
+	// Cleanup
+	defer func() {
+		db.ExecContext(ctx, "DELETE FROM user_setting WHERE user_id >= 2000 AND user_id < 2100")
+	}()
+
+	// Insert 100 users with PATs
+	for i := 2000; i < 2100; i++ {
+		json := `{
+			"tokens": [
+				{
+					"tokenId": "pat-` + string(rune(i)) + `",
+					"tokenHash": "hash-` + string(rune(i)) + `",
+					"description": "Test PAT"
+				}
+			]
+		}`
+		_, err = db.ExecContext(ctx, `
+			INSERT INTO user_setting (user_id, key, value)
+			VALUES ($1, $2, $3)
+			ON CONFLICT (user_id, key) DO UPDATE SET value = EXCLUDED.value
+		`, i, "PERSONAL_ACCESS_TOKENS", json)
+		require.NoError(t, err)
+	}
+
+	// Query should complete quickly even with 100 users
+	result, err := driver.GetUserByPATHash(ctx, "hash-"+string(rune(2050)))
+	assert.NoError(t, err)
+	assert.NotNil(t, result)
+	assert.Equal(t, int32(2050), result.UserID)
+}
+
+// getTestDSN returns PostgreSQL DSN from environment or returns empty string.
+func getTestDSN() string {
+	// For unit tests, we expect TEST_POSTGRES_DSN to be set.
+	// Example: TEST_POSTGRES_DSN="postgresql://user:pass@localhost:5432/memos_test?sslmode=disable".
+	return ""
+}
+
+// TestUpsertUserSetting tests basic upsert functionality.
+func TestUpsertUserSetting(t *testing.T) {
+	dsn := getTestDSN()
+	if dsn == "" {
+		t.Skip("PostgreSQL DSN not provided, skipping test")
+	}
+
+	db, err := sql.Open("postgres", dsn)
+	require.NoError(t, err)
+	defer db.Close()
+
+	ctx := context.Background()
+	driver := &DB{db: db}
+
+	// Setup
+	_, err = db.ExecContext(ctx, `
+		CREATE TABLE IF NOT EXISTS user_setting (
+			user_id INTEGER NOT NULL,
+			key TEXT NOT NULL,
+			value TEXT NOT NULL,
+			UNIQUE(user_id, key)
+		)
+	`)
+	require.NoError(t, err)
+
+	defer func() {
+		db.ExecContext(ctx, "DELETE FROM user_setting WHERE user_id = 9999")
+	}()
+
+	// Test insert
+	setting := &store.UserSetting{
+		UserID: 9999,
+		Key:    storepb.UserSetting_GENERAL,
+		Value:  `{"locale":"en"}`,
+	}
+	result, err := driver.UpsertUserSetting(ctx, setting)
+	assert.NoError(t, err)
+	assert.NotNil(t, result)
+	assert.Equal(t, int32(9999), result.UserID)
+
+	// Test update (upsert on conflict)
+	setting.Value = `{"locale":"zh"}`
+	result, err = driver.UpsertUserSetting(ctx, setting)
+	assert.NoError(t, err)
+	assert.Equal(t, `{"locale":"zh"}`, result.Value)
+}

store/db/sqlite/activity.go

@@ -0,0 +1,83 @@
+package sqlite
+
+import (
+	"context"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateActivity(ctx context.Context, create *store.Activity) (*store.Activity, error) {
+	payloadString := "{}"
+	if create.Payload != nil {
+		bytes, err := protojson.Marshal(create.Payload)
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to marshal activity payload")
+		}
+		payloadString = string(bytes)
+	}
+
+	fields := []string{"`creator_id`", "`type`", "`level`", "`payload`"}
+	placeholder := []string{"?", "?", "?", "?"}
+	args := []any{create.CreatorID, create.Type.String(), create.Level.String(), payloadString}
+
+	stmt := "INSERT INTO activity (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ") RETURNING `id`, `created_ts`"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&create.ID,
+		&create.CreatedTs,
+	); err != nil {
+		return nil, err
+	}
+
+	return create, nil
+}
+
+func (d *DB) ListActivities(ctx context.Context, find *store.FindActivity) ([]*store.Activity, error) {
+	where, args := []string{"1 = 1"}, []any{}
+	if find.ID != nil {
+		where, args = append(where, "`id` = ?"), append(args, *find.ID)
+	}
+	if find.Type != nil {
+		where, args = append(where, "`type` = ?"), append(args, find.Type.String())
+	}
+
+	query := "SELECT `id`, `creator_id`, `type`, `level`, `payload`, `created_ts` FROM `activity` WHERE " + strings.Join(where, " AND ") + " ORDER BY `created_ts` DESC"
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.Activity{}
+	for rows.Next() {
+		activity := &store.Activity{}
+		var payloadBytes []byte
+		if err := rows.Scan(
+			&activity.ID,
+			&activity.CreatorID,
+			&activity.Type,
+			&activity.Level,
+			&payloadBytes,
+			&activity.CreatedTs,
+		); err != nil {
+			return nil, err
+		}
+
+		payload := &storepb.ActivityPayload{}
+		if err := protojsonUnmarshaler.Unmarshal(payloadBytes, payload); err != nil {
+			return nil, err
+		}
+		activity.Payload = payload
+		list = append(list, activity)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}

store/db/sqlite/attachment.go

@@ -0,0 +1,221 @@
+package sqlite
+
+import (
+	"context"
+	"database/sql"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	"github.com/usememos/memos/plugin/filter"
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateAttachment(ctx context.Context, create *store.Attachment) (*store.Attachment, error) {
+	fields := []string{"`uid`", "`filename`", "`blob`", "`type`", "`size`", "`creator_id`", "`memo_id`", "`storage_type`", "`reference`", "`payload`"}
+	placeholder := []string{"?", "?", "?", "?", "?", "?", "?", "?", "?", "?"}
+	storageType := ""
+	if create.StorageType != storepb.AttachmentStorageType_ATTACHMENT_STORAGE_TYPE_UNSPECIFIED {
+		storageType = create.StorageType.String()
+	}
+	payloadString := "{}"
+	if create.Payload != nil {
+		bytes, err := protojson.Marshal(create.Payload)
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to marshal attachment payload")
+		}
+		payloadString = string(bytes)
+	}
+	args := []any{create.UID, create.Filename, create.Blob, create.Type, create.Size, create.CreatorID, create.MemoID, storageType, create.Reference, payloadString}
+
+	stmt := "INSERT INTO `attachment` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ") RETURNING `id`, `created_ts`, `updated_ts`"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(&create.ID, &create.CreatedTs, &create.UpdatedTs); err != nil {
+		return nil, err
+	}
+
+	return create, nil
+}
+
+func (d *DB) ListAttachments(ctx context.Context, find *store.FindAttachment) ([]*store.Attachment, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if v := find.ID; v != nil {
+		where, args = append(where, "`attachment`.`id` = ?"), append(args, *v)
+	}
+	if v := find.UID; v != nil {
+		where, args = append(where, "`attachment`.`uid` = ?"), append(args, *v)
+	}
+	if v := find.CreatorID; v != nil {
+		where, args = append(where, "`attachment`.`creator_id` = ?"), append(args, *v)
+	}
+	if v := find.Filename; v != nil {
+		where, args = append(where, "`attachment`.`filename` = ?"), append(args, *v)
+	}
+	if v := find.FilenameSearch; v != nil {
+		where, args = append(where, "`attachment`.`filename` LIKE ?"), append(args, fmt.Sprintf("%%%s%%", *v))
+	}
+	if v := find.MemoID; v != nil {
+		where, args = append(where, "`attachment`.`memo_id` = ?"), append(args, *v)
+	}
+	if len(find.MemoIDList) > 0 {
+		placeholders := make([]string, 0, len(find.MemoIDList))
+		for range find.MemoIDList {
+			placeholders = append(placeholders, "?")
+		}
+		where = append(where, "`attachment`.`memo_id` IN ("+strings.Join(placeholders, ",")+")")
+		for _, id := range find.MemoIDList {
+			args = append(args, id)
+		}
+	}
+	if find.HasRelatedMemo {
+		where = append(where, "`attachment`.`memo_id` IS NOT NULL")
+	}
+	if find.StorageType != nil {
+		where, args = append(where, "`attachment`.`storage_type` = ?"), append(args, find.StorageType.String())
+	}
+
+	if len(find.Filters) > 0 {
+		engine, err := filter.DefaultAttachmentEngine()
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to get filter engine")
+		}
+		if err := filter.AppendConditions(ctx, engine, find.Filters, filter.DialectSQLite, &where, &args); err != nil {
+			return nil, errors.Wrap(err, "failed to append filter conditions")
+		}
+	}
+
+	fields := []string{
+		"`attachment`.`id` AS `id`",
+		"`attachment`.`uid` AS `uid`",
+		"`attachment`.`filename` AS `filename`",
+		"`attachment`.`type` AS `type`",
+		"`attachment`.`size` AS `size`",
+		"`attachment`.`creator_id` AS `creator_id`",
+		"`attachment`.`created_ts` AS `created_ts`",
+		"`attachment`.`updated_ts` AS `updated_ts`",
+		"`attachment`.`memo_id` AS `memo_id`",
+		"`attachment`.`storage_type` AS `storage_type`",
+		"`attachment`.`reference` AS `reference`",
+		"`attachment`.`payload` AS `payload`",
+		"CASE WHEN `memo`.`uid` IS NOT NULL THEN `memo`.`uid` ELSE NULL END AS `memo_uid`",
+	}
+	if find.GetBlob {
+		fields = append(fields, "`attachment`.`blob` AS `blob`")
+	}
+
+	query := "SELECT " + strings.Join(fields, ", ") + " FROM `attachment`" + " " +
+		"LEFT JOIN `memo` ON `attachment`.`memo_id` = `memo`.`id`" + " " +
+		"WHERE " + strings.Join(where, " AND ") + " " +
+		"ORDER BY `attachment`.`updated_ts` DESC"
+	if find.Limit != nil {
+		query = fmt.Sprintf("%s LIMIT %d", query, *find.Limit)
+		if find.Offset != nil {
+			query = fmt.Sprintf("%s OFFSET %d", query, *find.Offset)
+		}
+	}
+
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := make([]*store.Attachment, 0)
+	for rows.Next() {
+		attachment := store.Attachment{}
+		var memoID sql.NullInt32
+		var storageType string
+		var payloadBytes []byte
+		dests := []any{
+			&attachment.ID,
+			&attachment.UID,
+			&attachment.Filename,
+			&attachment.Type,
+			&attachment.Size,
+			&attachment.CreatorID,
+			&attachment.CreatedTs,
+			&attachment.UpdatedTs,
+			&memoID,
+			&storageType,
+			&attachment.Reference,
+			&payloadBytes,
+			&attachment.MemoUID,
+		}
+		if find.GetBlob {
+			dests = append(dests, &attachment.Blob)
+		}
+		if err := rows.Scan(dests...); err != nil {
+			return nil, err
+		}
+
+		if memoID.Valid {
+			attachment.MemoID = &memoID.Int32
+		}
+		attachment.StorageType = storepb.AttachmentStorageType(storepb.AttachmentStorageType_value[storageType])
+		payload := &storepb.AttachmentPayload{}
+		if err := protojsonUnmarshaler.Unmarshal(payloadBytes, payload); err != nil {
+			return nil, err
+		}
+		attachment.Payload = payload
+		list = append(list, &attachment)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) UpdateAttachment(ctx context.Context, update *store.UpdateAttachment) error {
+	set, args := []string{}, []any{}
+
+	if v := update.UID; v != nil {
+		set, args = append(set, "`uid` = ?"), append(args, *v)
+	}
+	if v := update.UpdatedTs; v != nil {
+		set, args = append(set, "`updated_ts` = ?"), append(args, *v)
+	}
+	if v := update.Filename; v != nil {
+		set, args = append(set, "`filename` = ?"), append(args, *v)
+	}
+	if v := update.MemoID; v != nil {
+		set, args = append(set, "`memo_id` = ?"), append(args, *v)
+	}
+	if v := update.Reference; v != nil {
+		set, args = append(set, "`reference` = ?"), append(args, *v)
+	}
+	if v := update.Payload; v != nil {
+		bytes, err := protojson.Marshal(v)
+		if err != nil {
+			return errors.Wrap(err, "failed to marshal attachment payload")
+		}
+		set, args = append(set, "`payload` = ?"), append(args, string(bytes))
+	}
+
+	args = append(args, update.ID)
+	stmt := "UPDATE `attachment` SET " + strings.Join(set, ", ") + " WHERE `id` = ?"
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return errors.Wrap(err, "failed to update attachment")
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}
+
+func (d *DB) DeleteAttachment(ctx context.Context, delete *store.DeleteAttachment) error {
+	stmt := "DELETE FROM `attachment` WHERE `id` = ?"
+	result, err := d.db.ExecContext(ctx, stmt, delete.ID)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/sqlite/common.go

@@ -0,0 +1,9 @@
+package sqlite
+
+import "google.golang.org/protobuf/encoding/protojson"
+
+var (
+	protojsonUnmarshaler = protojson.UnmarshalOptions{
+		DiscardUnknown: true,
+	}
+)

store/db/sqlite/functions.go

@@ -0,0 +1,44 @@
+// Package sqlite provides SQLite driver implementation with custom functions.
+// Custom functions are registered globally on first use to extend SQLite's
+// limited ASCII-only text operations with proper Unicode support.
+package sqlite
+
+import (
+	"database/sql/driver"
+	"sync"
+
+	"golang.org/x/text/cases"
+	msqlite "modernc.org/sqlite"
+)
+
+var (
+	registerUnicodeLowerOnce sync.Once
+	registerUnicodeLowerErr  error
+	// unicodeFold provides Unicode case folding for case-insensitive comparisons.
+	// It's safe to use concurrently and reused across all function calls.
+	unicodeFold = cases.Fold()
+)
+
+// ensureUnicodeLowerRegistered registers the memos_unicode_lower custom function
+// with SQLite. This function provides proper Unicode case folding for case-insensitive
+// text comparisons, overcoming modernc.org/sqlite's lack of ICU extension.
+//
+// The function is registered once globally and is safe to call multiple times.
+func ensureUnicodeLowerRegistered() error {
+	registerUnicodeLowerOnce.Do(func() {
+		registerUnicodeLowerErr = msqlite.RegisterScalarFunction("memos_unicode_lower", 1, func(_ *msqlite.FunctionContext, args []driver.Value) (driver.Value, error) {
+			if len(args) == 0 || args[0] == nil {
+				return nil, nil
+			}
+			switch v := args[0].(type) {
+			case string:
+				return unicodeFold.String(v), nil
+			case []byte:
+				return unicodeFold.String(string(v)), nil
+			default:
+				return v, nil
+			}
+		})
+	})
+	return registerUnicodeLowerErr
+}

store/db/sqlite/idp.go

@@ -0,0 +1,117 @@
+package sqlite
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateIdentityProvider(ctx context.Context, create *store.IdentityProvider) (*store.IdentityProvider, error) {
+	placeholders := []string{"?", "?", "?", "?"}
+	fields := []string{"`name`", "`type`", "`identifier_filter`", "`config`"}
+	args := []any{create.Name, create.Type.String(), create.IdentifierFilter, create.Config}
+
+	stmt := "INSERT INTO `idp` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholders, ", ") + ") RETURNING `id`"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(&create.ID); err != nil {
+		return nil, err
+	}
+
+	identityProvider := create
+	return identityProvider, nil
+}
+
+func (d *DB) ListIdentityProviders(ctx context.Context, find *store.FindIdentityProvider) ([]*store.IdentityProvider, error) {
+	where, args := []string{"1 = 1"}, []any{}
+	if v := find.ID; v != nil {
+		where, args = append(where, fmt.Sprintf("id = $%d", len(args)+1)), append(args, *v)
+	}
+
+	rows, err := d.db.QueryContext(ctx, `
+		SELECT
+			id,
+			name,
+			type,
+			identifier_filter,
+			config
+		FROM idp
+		WHERE `+strings.Join(where, " AND ")+` ORDER BY id ASC`,
+		args...,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	var identityProviders []*store.IdentityProvider
+	for rows.Next() {
+		var identityProvider store.IdentityProvider
+		var typeString string
+		if err := rows.Scan(
+			&identityProvider.ID,
+			&identityProvider.Name,
+			&typeString,
+			&identityProvider.IdentifierFilter,
+			&identityProvider.Config,
+		); err != nil {
+			return nil, err
+		}
+		identityProvider.Type = storepb.IdentityProvider_Type(storepb.IdentityProvider_Type_value[typeString])
+		identityProviders = append(identityProviders, &identityProvider)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return identityProviders, nil
+}
+
+func (d *DB) UpdateIdentityProvider(ctx context.Context, update *store.UpdateIdentityProvider) (*store.IdentityProvider, error) {
+	set, args := []string{}, []any{}
+	if v := update.Name; v != nil {
+		set, args = append(set, "name = ?"), append(args, *v)
+	}
+	if v := update.IdentifierFilter; v != nil {
+		set, args = append(set, "identifier_filter = ?"), append(args, *v)
+	}
+	if v := update.Config; v != nil {
+		set, args = append(set, "config = ?"), append(args, *v)
+	}
+	args = append(args, update.ID)
+
+	stmt := `
+		UPDATE idp
+		SET ` + strings.Join(set, ", ") + `
+		WHERE id = ?
+		RETURNING id, name, type, identifier_filter, config
+	`
+	var identityProvider store.IdentityProvider
+	var typeString string
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&identityProvider.ID,
+		&identityProvider.Name,
+		&typeString,
+		&identityProvider.IdentifierFilter,
+		&identityProvider.Config,
+	); err != nil {
+		return nil, err
+	}
+	identityProvider.Type = storepb.IdentityProvider_Type(storepb.IdentityProvider_Type_value[typeString])
+	return &identityProvider, nil
+}
+
+func (d *DB) DeleteIdentityProvider(ctx context.Context, delete *store.DeleteIdentityProvider) error {
+	where, args := []string{"id = ?"}, []any{delete.ID}
+	stmt := `DELETE FROM idp WHERE ` + strings.Join(where, " AND ")
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return err
+	}
+	if _, err = result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/sqlite/inbox.go

@@ -0,0 +1,141 @@
+package sqlite
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateInbox(ctx context.Context, create *store.Inbox) (*store.Inbox, error) {
+	messageString := "{}"
+	if create.Message != nil {
+		bytes, err := protojson.Marshal(create.Message)
+		if err != nil {
+			return nil, errors.Wrap(err, "failed to marshal inbox message")
+		}
+		messageString = string(bytes)
+	}
+
+	fields := []string{"`sender_id`", "`receiver_id`", "`status`", "`message`"}
+	placeholder := []string{"?", "?", "?", "?"}
+	args := []any{create.SenderID, create.ReceiverID, create.Status, messageString}
+
+	stmt := "INSERT INTO `inbox` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ") RETURNING `id`, `created_ts`"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&create.ID,
+		&create.CreatedTs,
+	); err != nil {
+		return nil, err
+	}
+
+	return create, nil
+}
+
+func (d *DB) ListInboxes(ctx context.Context, find *store.FindInbox) ([]*store.Inbox, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if find.ID != nil {
+		where, args = append(where, "`id` = ?"), append(args, *find.ID)
+	}
+	if find.SenderID != nil {
+		where, args = append(where, "`sender_id` = ?"), append(args, *find.SenderID)
+	}
+	if find.ReceiverID != nil {
+		where, args = append(where, "`receiver_id` = ?"), append(args, *find.ReceiverID)
+	}
+	if find.Status != nil {
+		where, args = append(where, "`status` = ?"), append(args, *find.Status)
+	}
+	if find.MessageType != nil {
+		// Filter by message type using JSON extraction
+		// Note: The type field in JSON is stored as string representation of the enum name
+		if *find.MessageType == storepb.InboxMessage_TYPE_UNSPECIFIED {
+			where, args = append(where, "(JSON_EXTRACT(`message`, '$.type') IS NULL OR JSON_EXTRACT(`message`, '$.type') = ?)"), append(args, find.MessageType.String())
+		} else {
+			where, args = append(where, "JSON_EXTRACT(`message`, '$.type') = ?"), append(args, find.MessageType.String())
+		}
+	}
+
+	query := "SELECT `id`, `created_ts`, `sender_id`, `receiver_id`, `status`, `message` FROM `inbox` WHERE " + strings.Join(where, " AND ") + " ORDER BY `created_ts` DESC"
+	if find.Limit != nil {
+		query = fmt.Sprintf("%s LIMIT %d", query, *find.Limit)
+		if find.Offset != nil {
+			query = fmt.Sprintf("%s OFFSET %d", query, *find.Offset)
+		}
+	}
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.Inbox{}
+	for rows.Next() {
+		inbox := &store.Inbox{}
+		var messageBytes []byte
+		if err := rows.Scan(
+			&inbox.ID,
+			&inbox.CreatedTs,
+			&inbox.SenderID,
+			&inbox.ReceiverID,
+			&inbox.Status,
+			&messageBytes,
+		); err != nil {
+			return nil, err
+		}
+
+		message := &storepb.InboxMessage{}
+		if err := protojsonUnmarshaler.Unmarshal(messageBytes, message); err != nil {
+			return nil, err
+		}
+		inbox.Message = message
+		list = append(list, inbox)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) UpdateInbox(ctx context.Context, update *store.UpdateInbox) (*store.Inbox, error) {
+	set, args := []string{"`status` = ?"}, []any{update.Status.String()}
+	args = append(args, update.ID)
+	query := "UPDATE `inbox` SET " + strings.Join(set, ", ") + " WHERE `id` = ? RETURNING `id`, `created_ts`, `sender_id`, `receiver_id`, `status`, `message`"
+	inbox := &store.Inbox{}
+	var messageBytes []byte
+	if err := d.db.QueryRowContext(ctx, query, args...).Scan(
+		&inbox.ID,
+		&inbox.CreatedTs,
+		&inbox.SenderID,
+		&inbox.ReceiverID,
+		&inbox.Status,
+		&messageBytes,
+	); err != nil {
+		return nil, err
+	}
+	message := &storepb.InboxMessage{}
+	if err := protojsonUnmarshaler.Unmarshal(messageBytes, message); err != nil {
+		return nil, err
+	}
+	inbox.Message = message
+	return inbox, nil
+}
+
+func (d *DB) DeleteInbox(ctx context.Context, delete *store.DeleteInbox) error {
+	result, err := d.db.ExecContext(ctx, "DELETE FROM `inbox` WHERE `id` = ?", delete.ID)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/sqlite/instance_setting.go

@@ -0,0 +1,72 @@
+package sqlite
+
+import (
+	"context"
+	"strings"
+
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertInstanceSetting(ctx context.Context, upsert *store.InstanceSetting) (*store.InstanceSetting, error) {
+	stmt := `
+		INSERT INTO system_setting (
+			name, value, description
+		)
+		VALUES (?, ?, ?)
+		ON CONFLICT(name) DO UPDATE
+		SET
+			value = EXCLUDED.value,
+			description = EXCLUDED.description
+	`
+	if _, err := d.db.ExecContext(ctx, stmt, upsert.Name, upsert.Value, upsert.Description); err != nil {
+		return nil, err
+	}
+
+	return upsert, nil
+}
+
+func (d *DB) ListInstanceSettings(ctx context.Context, find *store.FindInstanceSetting) ([]*store.InstanceSetting, error) {
+	where, args := []string{"1 = 1"}, []any{}
+	if find.Name != "" {
+		where, args = append(where, "name = ?"), append(args, find.Name)
+	}
+
+	query := `
+		SELECT
+			name,
+			value,
+			description
+		FROM system_setting
+		WHERE ` + strings.Join(where, " AND ")
+
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.InstanceSetting{}
+	for rows.Next() {
+		systemSettingMessage := &store.InstanceSetting{}
+		if err := rows.Scan(
+			&systemSettingMessage.Name,
+			&systemSettingMessage.Value,
+			&systemSettingMessage.Description,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, systemSettingMessage)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) DeleteInstanceSetting(ctx context.Context, delete *store.DeleteInstanceSetting) error {
+	stmt := "DELETE FROM system_setting WHERE name = ?"
+	_, err := d.db.ExecContext(ctx, stmt, delete.Name)
+	return err
+}

store/db/sqlite/memo.go

@@ -0,0 +1,247 @@
+package sqlite
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	"github.com/usememos/memos/plugin/filter"
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateMemo(ctx context.Context, create *store.Memo) (*store.Memo, error) {
+	fields := []string{"`uid`", "`creator_id`", "`content`", "`visibility`", "`payload`"}
+	placeholder := []string{"?", "?", "?", "?", "?"}
+	payload := "{}"
+	if create.Payload != nil {
+		payloadBytes, err := protojson.Marshal(create.Payload)
+		if err != nil {
+			return nil, err
+		}
+		payload = string(payloadBytes)
+	}
+	args := []any{create.UID, create.CreatorID, create.Content, create.Visibility, payload}
+
+	// Add custom timestamps if provided
+	if create.CreatedTs != 0 {
+		fields = append(fields, "`created_ts`")
+		placeholder = append(placeholder, "?")
+		args = append(args, create.CreatedTs)
+	}
+	if create.UpdatedTs != 0 {
+		fields = append(fields, "`updated_ts`")
+		placeholder = append(placeholder, "?")
+		args = append(args, create.UpdatedTs)
+	}
+
+	stmt := "INSERT INTO `memo` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ") RETURNING `id`, `created_ts`, `updated_ts`, `row_status`"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&create.ID,
+		&create.CreatedTs,
+		&create.UpdatedTs,
+		&create.RowStatus,
+	); err != nil {
+		return nil, err
+	}
+
+	return create, nil
+}
+
+func (d *DB) ListMemos(ctx context.Context, find *store.FindMemo) ([]*store.Memo, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	engine, err := filter.DefaultEngine()
+	if err != nil {
+		return nil, err
+	}
+	if err := filter.AppendConditions(ctx, engine, find.Filters, filter.DialectSQLite, &where, &args); err != nil {
+		return nil, err
+	}
+	if v := find.ID; v != nil {
+		where, args = append(where, "`memo`.`id` = ?"), append(args, *v)
+	}
+	if len(find.IDList) > 0 {
+		placeholders := make([]string, 0, len(find.IDList))
+		for range find.IDList {
+			placeholders = append(placeholders, "?")
+		}
+		where = append(where, "`memo`.`id` IN ("+strings.Join(placeholders, ",")+")")
+		for _, id := range find.IDList {
+			args = append(args, id)
+		}
+	}
+	if v := find.UID; v != nil {
+		where, args = append(where, "`memo`.`uid` = ?"), append(args, *v)
+	}
+	if len(find.UIDList) > 0 {
+		placeholders := make([]string, 0, len(find.UIDList))
+		for range find.UIDList {
+			placeholders = append(placeholders, "?")
+		}
+		where = append(where, "`memo`.`uid` IN ("+strings.Join(placeholders, ",")+")")
+		for _, uid := range find.UIDList {
+			args = append(args, uid)
+		}
+	}
+	if v := find.CreatorID; v != nil {
+		where, args = append(where, "`memo`.`creator_id` = ?"), append(args, *v)
+	}
+	if v := find.RowStatus; v != nil {
+		where, args = append(where, "`memo`.`row_status` = ?"), append(args, *v)
+	}
+	if v := find.VisibilityList; len(v) != 0 {
+		placeholder := []string{}
+		for _, visibility := range v {
+			placeholder = append(placeholder, "?")
+			args = append(args, visibility.String())
+		}
+		where = append(where, fmt.Sprintf("`memo`.`visibility` IN (%s)", strings.Join(placeholder, ",")))
+	}
+	if find.ExcludeComments {
+		where = append(where, "`parent_uid` IS NULL")
+	}
+
+	order := "DESC"
+	if find.OrderByTimeAsc {
+		order = "ASC"
+	}
+	orderBy := []string{}
+	if find.OrderByPinned {
+		orderBy = append(orderBy, "`pinned` DESC")
+	}
+	if find.OrderByUpdatedTs {
+		orderBy = append(orderBy, "`updated_ts` "+order)
+	} else {
+		orderBy = append(orderBy, "`created_ts` "+order)
+	}
+	// Add id as final tie-breaker
+	orderBy = append(orderBy, "`id` DESC")
+	fields := []string{
+		"`memo`.`id` AS `id`",
+		"`memo`.`uid` AS `uid`",
+		"`memo`.`creator_id` AS `creator_id`",
+		"`memo`.`created_ts` AS `created_ts`",
+		"`memo`.`updated_ts` AS `updated_ts`",
+		"`memo`.`row_status` AS `row_status`",
+		"`memo`.`visibility` AS `visibility`",
+		"`memo`.`pinned` AS `pinned`",
+		"`memo`.`payload` AS `payload`",
+		"CASE WHEN `parent_memo`.`uid` IS NOT NULL THEN `parent_memo`.`uid` ELSE NULL END AS `parent_uid`",
+	}
+	if !find.ExcludeContent {
+		fields = append(fields, "`memo`.`content` AS `content`")
+	}
+
+	query := "SELECT " + strings.Join(fields, ", ") + "FROM `memo` " +
+		"LEFT JOIN `memo_relation` ON `memo`.`id` = `memo_relation`.`memo_id` AND `memo_relation`.`type` = \"COMMENT\" " +
+		"LEFT JOIN `memo` AS `parent_memo` ON `memo_relation`.`related_memo_id` = `parent_memo`.`id` " +
+		"WHERE " + strings.Join(where, " AND ") + " " +
+		"ORDER BY " + strings.Join(orderBy, ", ")
+	if find.Limit != nil {
+		query = fmt.Sprintf("%s LIMIT %d", query, *find.Limit)
+		if find.Offset != nil {
+			query = fmt.Sprintf("%s OFFSET %d", query, *find.Offset)
+		}
+	}
+
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := make([]*store.Memo, 0)
+	for rows.Next() {
+		var memo store.Memo
+		var payloadBytes []byte
+		dests := []any{
+			&memo.ID,
+			&memo.UID,
+			&memo.CreatorID,
+			&memo.CreatedTs,
+			&memo.UpdatedTs,
+			&memo.RowStatus,
+			&memo.Visibility,
+			&memo.Pinned,
+			&payloadBytes,
+			&memo.ParentUID,
+		}
+		if !find.ExcludeContent {
+			dests = append(dests, &memo.Content)
+		}
+		if err := rows.Scan(dests...); err != nil {
+			return nil, err
+		}
+		payload := &storepb.MemoPayload{}
+		if err := protojsonUnmarshaler.Unmarshal(payloadBytes, payload); err != nil {
+			return nil, errors.Wrap(err, "failed to unmarshal payload")
+		}
+		memo.Payload = payload
+		list = append(list, &memo)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) UpdateMemo(ctx context.Context, update *store.UpdateMemo) error {
+	set, args := []string{}, []any{}
+	if v := update.UID; v != nil {
+		set, args = append(set, "`uid` = ?"), append(args, *v)
+	}
+	if v := update.CreatedTs; v != nil {
+		set, args = append(set, "`created_ts` = ?"), append(args, *v)
+	}
+	if v := update.UpdatedTs; v != nil {
+		set, args = append(set, "`updated_ts` = ?"), append(args, *v)
+	}
+	if v := update.RowStatus; v != nil {
+		set, args = append(set, "`row_status` = ?"), append(args, *v)
+	}
+	if v := update.Content; v != nil {
+		set, args = append(set, "`content` = ?"), append(args, *v)
+	}
+	if v := update.Visibility; v != nil {
+		set, args = append(set, "`visibility` = ?"), append(args, *v)
+	}
+	if v := update.Pinned; v != nil {
+		set, args = append(set, "`pinned` = ?"), append(args, *v)
+	}
+	if v := update.Payload; v != nil {
+		payloadBytes, err := protojson.Marshal(v)
+		if err != nil {
+			return err
+		}
+		set, args = append(set, "`payload` = ?"), append(args, string(payloadBytes))
+	}
+	if len(set) == 0 {
+		return nil
+	}
+	args = append(args, update.ID)
+
+	stmt := "UPDATE `memo` SET " + strings.Join(set, ", ") + " WHERE `id` = ?"
+	if _, err := d.db.ExecContext(ctx, stmt, args...); err != nil {
+		return err
+	}
+	return nil
+}
+
+func (d *DB) DeleteMemo(ctx context.Context, delete *store.DeleteMemo) error {
+	where, args := []string{"`id` = ?"}, []any{delete.ID}
+	stmt := "DELETE FROM `memo` WHERE " + strings.Join(where, " AND ")
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/sqlite/memo_relation.go

@@ -0,0 +1,122 @@
+package sqlite
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/usememos/memos/plugin/filter"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertMemoRelation(ctx context.Context, create *store.MemoRelation) (*store.MemoRelation, error) {
+	stmt := `
+		INSERT INTO memo_relation (
+			memo_id,
+			related_memo_id,
+			type
+		)
+		VALUES (?, ?, ?)
+		ON CONFLICT(memo_id, related_memo_id, type) DO UPDATE SET type = excluded.type
+		RETURNING memo_id, related_memo_id, type
+	`
+	memoRelation := &store.MemoRelation{}
+	if err := d.db.QueryRowContext(
+		ctx,
+		stmt,
+		create.MemoID,
+		create.RelatedMemoID,
+		create.Type,
+	).Scan(
+		&memoRelation.MemoID,
+		&memoRelation.RelatedMemoID,
+		&memoRelation.Type,
+	); err != nil {
+		return nil, err
+	}
+
+	return memoRelation, nil
+}
+
+func (d *DB) ListMemoRelations(ctx context.Context, find *store.FindMemoRelation) ([]*store.MemoRelation, error) {
+	where, args := []string{"TRUE"}, []any{}
+	if find.MemoID != nil {
+		where, args = append(where, "memo_id = ?"), append(args, find.MemoID)
+	}
+	if find.RelatedMemoID != nil {
+		where, args = append(where, "related_memo_id = ?"), append(args, find.RelatedMemoID)
+	}
+	if find.Type != nil {
+		where, args = append(where, "type = ?"), append(args, find.Type)
+	}
+	if find.MemoFilter != nil {
+		engine, err := filter.DefaultEngine()
+		if err != nil {
+			return nil, err
+		}
+		stmt, err := engine.CompileToStatement(ctx, *find.MemoFilter, filter.RenderOptions{Dialect: filter.DialectSQLite})
+		if err != nil {
+			return nil, err
+		}
+		if stmt.SQL != "" {
+			where = append(where, fmt.Sprintf("memo_id IN (SELECT id FROM memo WHERE %s)", stmt.SQL))
+			where = append(where, fmt.Sprintf("related_memo_id IN (SELECT id FROM memo WHERE %s)", stmt.SQL))
+			args = append(args, append(stmt.Args, stmt.Args...)...)
+		}
+	}
+
+	rows, err := d.db.QueryContext(ctx, `
+		SELECT
+			memo_id,
+			related_memo_id,
+			type
+		FROM memo_relation
+		WHERE `+strings.Join(where, " AND "), args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.MemoRelation{}
+	for rows.Next() {
+		memoRelation := &store.MemoRelation{}
+		if err := rows.Scan(
+			&memoRelation.MemoID,
+			&memoRelation.RelatedMemoID,
+			&memoRelation.Type,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, memoRelation)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) DeleteMemoRelation(ctx context.Context, delete *store.DeleteMemoRelation) error {
+	where, args := []string{"TRUE"}, []any{}
+	if delete.MemoID != nil {
+		where, args = append(where, "memo_id = ?"), append(args, delete.MemoID)
+	}
+	if delete.RelatedMemoID != nil {
+		where, args = append(where, "related_memo_id = ?"), append(args, delete.RelatedMemoID)
+	}
+	if delete.Type != nil {
+		where, args = append(where, "type = ?"), append(args, delete.Type)
+	}
+	stmt := `
+		DELETE FROM memo_relation
+		WHERE ` + strings.Join(where, " AND ")
+	result, err := d.db.ExecContext(ctx, stmt, args...)
+	if err != nil {
+		return err
+	}
+	if _, err = result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/sqlite/reaction.go

@@ -0,0 +1,136 @@
+package sqlite
+
+import (
+	"context"
+	"database/sql"
+	"errors"
+	"strings"
+
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertReaction(ctx context.Context, upsert *store.Reaction) (*store.Reaction, error) {
+	fields := []string{"`creator_id`", "`content_id`", "`reaction_type`"}
+	placeholder := []string{"?", "?", "?"}
+	args := []interface{}{upsert.CreatorID, upsert.ContentID, upsert.ReactionType}
+	stmt := "INSERT INTO `reaction` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ") RETURNING `id`, `created_ts`"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&upsert.ID,
+		&upsert.CreatedTs,
+	); err != nil {
+		return nil, err
+	}
+
+	reaction := upsert
+	return reaction, nil
+}
+
+func (d *DB) ListReactions(ctx context.Context, find *store.FindReaction) ([]*store.Reaction, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if find.ID != nil {
+		where, args = append(where, "id = ?"), append(args, *find.ID)
+	}
+	if find.CreatorID != nil {
+		where, args = append(where, "creator_id = ?"), append(args, *find.CreatorID)
+	}
+	if find.ContentID != nil {
+		where, args = append(where, "content_id = ?"), append(args, *find.ContentID)
+	}
+	if len(find.ContentIDList) > 0 {
+		placeholders := make([]string, 0, len(find.ContentIDList))
+		for range find.ContentIDList {
+			placeholders = append(placeholders, "?")
+		}
+		if len(placeholders) > 0 {
+			where = append(where, "content_id IN ("+strings.Join(placeholders, ",")+")")
+			for _, id := range find.ContentIDList {
+				args = append(args, id)
+			}
+		}
+	}
+
+	rows, err := d.db.QueryContext(ctx, `
+		SELECT
+			id,
+			created_ts,
+			creator_id,
+			content_id,
+			reaction_type
+		FROM reaction
+		WHERE `+strings.Join(where, " AND ")+`
+		ORDER BY id ASC`,
+		args...,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := []*store.Reaction{}
+	for rows.Next() {
+		reaction := &store.Reaction{}
+		if err := rows.Scan(
+			&reaction.ID,
+			&reaction.CreatedTs,
+			&reaction.CreatorID,
+			&reaction.ContentID,
+			&reaction.ReactionType,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, reaction)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) GetReaction(ctx context.Context, find *store.FindReaction) (*store.Reaction, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if find.ID != nil {
+		where, args = append(where, "id = ?"), append(args, *find.ID)
+	}
+	if find.CreatorID != nil {
+		where, args = append(where, "creator_id = ?"), append(args, *find.CreatorID)
+	}
+	if find.ContentID != nil {
+		where, args = append(where, "content_id = ?"), append(args, *find.ContentID)
+	}
+
+	reaction := &store.Reaction{}
+	if err := d.db.QueryRowContext(ctx, `
+		SELECT
+			id,
+			created_ts,
+			creator_id,
+			content_id,
+			reaction_type
+		FROM reaction
+		WHERE `+strings.Join(where, " AND ")+`
+		LIMIT 1`,
+		args...,
+	).Scan(
+		&reaction.ID,
+		&reaction.CreatedTs,
+		&reaction.CreatorID,
+		&reaction.ContentID,
+		&reaction.ReactionType,
+	); err != nil {
+		if errors.Is(err, sql.ErrNoRows) {
+			return nil, nil
+		}
+		return nil, err
+	}
+
+	return reaction, nil
+}
+
+func (d *DB) DeleteReaction(ctx context.Context, delete *store.DeleteReaction) error {
+	_, err := d.db.ExecContext(ctx, "DELETE FROM `reaction` WHERE `id` = ?", delete.ID)
+	return err
+}

store/db/sqlite/sqlite.go

@@ -0,0 +1,75 @@
+package sqlite
+
+import (
+	"context"
+	"database/sql"
+
+	"github.com/pkg/errors"
+
+	// Note: modernc.org/sqlite driver is imported in functions.go where
+	// RegisterScalarFunction is used. No blank import needed here.
+
+	"github.com/usememos/memos/internal/profile"
+	"github.com/usememos/memos/store"
+)
+
+type DB struct {
+	db      *sql.DB
+	profile *profile.Profile
+}
+
+// NewDB opens a database specified by its database driver name and a
+// driver-specific data source name, usually consisting of at least a
+// database name and connection information.
+func NewDB(profile *profile.Profile) (store.Driver, error) {
+	// Ensure a DSN is set before attempting to open the database.
+	if profile.DSN == "" {
+		return nil, errors.New("dsn required")
+	}
+
+	if err := ensureUnicodeLowerRegistered(); err != nil {
+		return nil, errors.Wrap(err, "failed to register sqlite unicode lower function")
+	}
+
+	// Connect to the database with some sane settings:
+	// - No shared-cache: it's obsolete; WAL journal mode is a better solution.
+	// - No foreign key constraints: it's currently disabled by default, but it's a
+	// good practice to be explicit and prevent future surprises on SQLite upgrades.
+	// - Journal mode set to WAL: it's the recommended journal mode for most applications
+	// as it prevents locking issues.
+	// - mmap size set to 0: it disables memory mapping, which can cause OOM errors on some systems.
+	//
+	// Notes:
+	// - When using the `modernc.org/sqlite` driver, each pragma must be prefixed with `_pragma=`.
+	//
+	// References:
+	// - https://pkg.go.dev/modernc.org/sqlite#Driver.Open
+	// - https://www.sqlite.org/sharedcache.html
+	// - https://www.sqlite.org/pragma.html
+	sqliteDB, err := sql.Open("sqlite", profile.DSN+"?_pragma=foreign_keys(0)&_pragma=busy_timeout(10000)&_pragma=journal_mode(WAL)&_pragma=mmap_size(0)")
+	if err != nil {
+		return nil, errors.Wrapf(err, "failed to open db with dsn: %s", profile.DSN)
+	}
+
+	driver := DB{db: sqliteDB, profile: profile}
+
+	return &driver, nil
+}
+
+func (d *DB) GetDB() *sql.DB {
+	return d.db
+}
+
+func (d *DB) Close() error {
+	return d.db.Close()
+}
+
+func (d *DB) IsInitialized(ctx context.Context) (bool, error) {
+	// Check if the database is initialized by checking if the memo table exists.
+	var exists bool
+	err := d.db.QueryRowContext(ctx, "SELECT EXISTS(SELECT 1 FROM sqlite_master WHERE type='table' AND name='memo')").Scan(&exists)
+	if err != nil {
+		return false, errors.Wrap(err, "failed to check if database is initialized")
+	}
+	return exists, nil
+}

store/db/sqlite/user.go

@@ -0,0 +1,176 @@
+package sqlite
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/pkg/errors"
+
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) CreateUser(ctx context.Context, create *store.User) (*store.User, error) {
+	fields := []string{"`username`", "`role`", "`email`", "`nickname`", "`password_hash`, `avatar_url`"}
+	placeholder := []string{"?", "?", "?", "?", "?", "?"}
+	args := []any{create.Username, create.Role, create.Email, create.Nickname, create.PasswordHash, create.AvatarURL}
+	stmt := "INSERT INTO user (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ") RETURNING id, description, created_ts, updated_ts, row_status"
+	if err := d.db.QueryRowContext(ctx, stmt, args...).Scan(
+		&create.ID,
+		&create.Description,
+		&create.CreatedTs,
+		&create.UpdatedTs,
+		&create.RowStatus,
+	); err != nil {
+		return nil, err
+	}
+
+	return create, nil
+}
+
+func (d *DB) UpdateUser(ctx context.Context, update *store.UpdateUser) (*store.User, error) {
+	set, args := []string{}, []any{}
+	if v := update.UpdatedTs; v != nil {
+		set, args = append(set, "updated_ts = ?"), append(args, *v)
+	}
+	if v := update.RowStatus; v != nil {
+		set, args = append(set, "row_status = ?"), append(args, *v)
+	}
+	if v := update.Username; v != nil {
+		set, args = append(set, "username = ?"), append(args, *v)
+	}
+	if v := update.Email; v != nil {
+		set, args = append(set, "email = ?"), append(args, *v)
+	}
+	if v := update.Nickname; v != nil {
+		set, args = append(set, "nickname = ?"), append(args, *v)
+	}
+	if v := update.AvatarURL; v != nil {
+		set, args = append(set, "avatar_url = ?"), append(args, *v)
+	}
+	if v := update.PasswordHash; v != nil {
+		set, args = append(set, "password_hash = ?"), append(args, *v)
+	}
+	if v := update.Description; v != nil {
+		set, args = append(set, "description = ?"), append(args, *v)
+	}
+	if v := update.Role; v != nil {
+		set, args = append(set, "role = ?"), append(args, *v)
+	}
+	args = append(args, update.ID)
+
+	query := `
+		UPDATE user
+		SET ` + strings.Join(set, ", ") + `
+		WHERE id = ?
+		RETURNING id, username, role, email, nickname, password_hash, avatar_url, description, created_ts, updated_ts, row_status
+	`
+	user := &store.User{}
+	if err := d.db.QueryRowContext(ctx, query, args...).Scan(
+		&user.ID,
+		&user.Username,
+		&user.Role,
+		&user.Email,
+		&user.Nickname,
+		&user.PasswordHash,
+		&user.AvatarURL,
+		&user.Description,
+		&user.CreatedTs,
+		&user.UpdatedTs,
+		&user.RowStatus,
+	); err != nil {
+		return nil, err
+	}
+
+	return user, nil
+}
+
+func (d *DB) ListUsers(ctx context.Context, find *store.FindUser) ([]*store.User, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if len(find.Filters) > 0 {
+		return nil, errors.Errorf("user filters are not supported")
+	}
+
+	if v := find.ID; v != nil {
+		where, args = append(where, "id = ?"), append(args, *v)
+	}
+	if v := find.Username; v != nil {
+		where, args = append(where, "username = ?"), append(args, *v)
+	}
+	if v := find.Role; v != nil {
+		where, args = append(where, "role = ?"), append(args, *v)
+	}
+	if v := find.Email; v != nil {
+		where, args = append(where, "email = ?"), append(args, *v)
+	}
+	if v := find.Nickname; v != nil {
+		where, args = append(where, "nickname = ?"), append(args, *v)
+	}
+
+	orderBy := []string{"created_ts DESC", "row_status DESC"}
+	query := `
+		SELECT 
+			id,
+			username,
+			role,
+			email,
+			nickname,
+			password_hash,
+			avatar_url,
+			description,
+			created_ts,
+			updated_ts,
+			row_status
+		FROM user
+		WHERE ` + strings.Join(where, " AND ") + ` ORDER BY ` + strings.Join(orderBy, ", ")
+	if v := find.Limit; v != nil {
+		query += fmt.Sprintf(" LIMIT %d", *v)
+	}
+
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	list := make([]*store.User, 0)
+	for rows.Next() {
+		var user store.User
+		if err := rows.Scan(
+			&user.ID,
+			&user.Username,
+			&user.Role,
+			&user.Email,
+			&user.Nickname,
+			&user.PasswordHash,
+			&user.AvatarURL,
+			&user.Description,
+			&user.CreatedTs,
+			&user.UpdatedTs,
+			&user.RowStatus,
+		); err != nil {
+			return nil, err
+		}
+		list = append(list, &user)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return list, nil
+}
+
+func (d *DB) DeleteUser(ctx context.Context, delete *store.DeleteUser) error {
+	result, err := d.db.ExecContext(ctx, `
+		DELETE FROM user WHERE id = ?
+	`, delete.ID)
+	if err != nil {
+		return err
+	}
+	if _, err := result.RowsAffected(); err != nil {
+		return err
+	}
+	return nil
+}

store/db/sqlite/user_setting.go

@@ -0,0 +1,109 @@
+package sqlite
+
+import (
+	"context"
+	"strings"
+
+	"github.com/pkg/errors"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+	"github.com/usememos/memos/store"
+)
+
+func (d *DB) UpsertUserSetting(ctx context.Context, upsert *store.UserSetting) (*store.UserSetting, error) {
+	stmt := `
+		INSERT INTO user_setting (
+			user_id, key, value
+		)
+		VALUES (?, ?, ?)
+		ON CONFLICT(user_id, key) DO UPDATE 
+		SET value = EXCLUDED.value
+	`
+	if _, err := d.db.ExecContext(ctx, stmt, upsert.UserID, upsert.Key.String(), upsert.Value); err != nil {
+		return nil, err
+	}
+	return upsert, nil
+}
+
+func (d *DB) ListUserSettings(ctx context.Context, find *store.FindUserSetting) ([]*store.UserSetting, error) {
+	where, args := []string{"1 = 1"}, []any{}
+
+	if v := find.Key; v != storepb.UserSetting_KEY_UNSPECIFIED {
+		where, args = append(where, "key = ?"), append(args, v.String())
+	}
+	if v := find.UserID; v != nil {
+		where, args = append(where, "user_id = ?"), append(args, *find.UserID)
+	}
+
+	query := `
+		SELECT
+			user_id,
+		  key,
+			value
+		FROM user_setting
+		WHERE ` + strings.Join(where, " AND ")
+	rows, err := d.db.QueryContext(ctx, query, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	userSettingList := make([]*store.UserSetting, 0)
+	for rows.Next() {
+		userSetting := &store.UserSetting{}
+		var keyString string
+		if err := rows.Scan(
+			&userSetting.UserID,
+			&keyString,
+			&userSetting.Value,
+		); err != nil {
+			return nil, err
+		}
+		userSetting.Key = storepb.UserSetting_Key(storepb.UserSetting_Key_value[keyString])
+		userSettingList = append(userSettingList, userSetting)
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return userSettingList, nil
+}
+
+func (d *DB) GetUserByPATHash(ctx context.Context, tokenHash string) (*store.PATQueryResult, error) {
+	query := `
+		SELECT
+			user_setting.user_id,
+			user_setting.value
+		FROM user_setting
+		WHERE user_setting.key = 'PERSONAL_ACCESS_TOKENS'
+			AND EXISTS (
+				SELECT 1
+				FROM json_each(json_extract(user_setting.value, '$.tokens')) AS token
+				WHERE json_extract(token.value, '$.tokenHash') = ?
+			)
+	`
+
+	var userID int32
+	var tokensJSON string
+
+	err := d.db.QueryRowContext(ctx, query, tokenHash).Scan(&userID, &tokensJSON)
+	if err != nil {
+		return nil, err
+	}
+
+	patsUserSetting := &storepb.PersonalAccessTokensUserSetting{}
+	if err := protojsonUnmarshaler.Unmarshal([]byte(tokensJSON), patsUserSetting); err != nil {
+		return nil, err
+	}
+
+	for _, pat := range patsUserSetting.Tokens {
+		if pat.TokenHash == tokenHash {
+			return &store.PATQueryResult{
+				UserID: userID,
+				PAT:    pat,
+			}, nil
+		}
+	}
+
+	return nil, errors.New("PAT not found")
+}

store/driver.go

@@ -0,0 +1,70 @@
+package store
+
+import (
+	"context"
+	"database/sql"
+)
+
+// Driver is an interface for store driver.
+// It contains all methods that store database driver should implement.
+type Driver interface {
+	GetDB() *sql.DB
+	Close() error
+
+	IsInitialized(ctx context.Context) (bool, error)
+
+	// Activity model related methods.
+	CreateActivity(ctx context.Context, create *Activity) (*Activity, error)
+	ListActivities(ctx context.Context, find *FindActivity) ([]*Activity, error)
+
+	// Attachment model related methods.
+	CreateAttachment(ctx context.Context, create *Attachment) (*Attachment, error)
+	ListAttachments(ctx context.Context, find *FindAttachment) ([]*Attachment, error)
+	UpdateAttachment(ctx context.Context, update *UpdateAttachment) error
+	DeleteAttachment(ctx context.Context, delete *DeleteAttachment) error
+
+	// Memo model related methods.
+	CreateMemo(ctx context.Context, create *Memo) (*Memo, error)
+	ListMemos(ctx context.Context, find *FindMemo) ([]*Memo, error)
+	UpdateMemo(ctx context.Context, update *UpdateMemo) error
+	DeleteMemo(ctx context.Context, delete *DeleteMemo) error
+
+	// MemoRelation model related methods.
+	UpsertMemoRelation(ctx context.Context, create *MemoRelation) (*MemoRelation, error)
+	ListMemoRelations(ctx context.Context, find *FindMemoRelation) ([]*MemoRelation, error)
+	DeleteMemoRelation(ctx context.Context, delete *DeleteMemoRelation) error
+
+	// InstanceSetting model related methods.
+	UpsertInstanceSetting(ctx context.Context, upsert *InstanceSetting) (*InstanceSetting, error)
+	ListInstanceSettings(ctx context.Context, find *FindInstanceSetting) ([]*InstanceSetting, error)
+	DeleteInstanceSetting(ctx context.Context, delete *DeleteInstanceSetting) error
+
+	// User model related methods.
+	CreateUser(ctx context.Context, create *User) (*User, error)
+	UpdateUser(ctx context.Context, update *UpdateUser) (*User, error)
+	ListUsers(ctx context.Context, find *FindUser) ([]*User, error)
+	DeleteUser(ctx context.Context, delete *DeleteUser) error
+
+	// UserSetting model related methods.
+	UpsertUserSetting(ctx context.Context, upsert *UserSetting) (*UserSetting, error)
+	ListUserSettings(ctx context.Context, find *FindUserSetting) ([]*UserSetting, error)
+	GetUserByPATHash(ctx context.Context, tokenHash string) (*PATQueryResult, error)
+
+	// IdentityProvider model related methods.
+	CreateIdentityProvider(ctx context.Context, create *IdentityProvider) (*IdentityProvider, error)
+	ListIdentityProviders(ctx context.Context, find *FindIdentityProvider) ([]*IdentityProvider, error)
+	UpdateIdentityProvider(ctx context.Context, update *UpdateIdentityProvider) (*IdentityProvider, error)
+	DeleteIdentityProvider(ctx context.Context, delete *DeleteIdentityProvider) error
+
+	// Inbox model related methods.
+	CreateInbox(ctx context.Context, create *Inbox) (*Inbox, error)
+	ListInboxes(ctx context.Context, find *FindInbox) ([]*Inbox, error)
+	UpdateInbox(ctx context.Context, update *UpdateInbox) (*Inbox, error)
+	DeleteInbox(ctx context.Context, delete *DeleteInbox) error
+
+	// Reaction model related methods.
+	UpsertReaction(ctx context.Context, create *Reaction) (*Reaction, error)
+	ListReactions(ctx context.Context, find *FindReaction) ([]*Reaction, error)
+	GetReaction(ctx context.Context, find *FindReaction) (*Reaction, error)
+	DeleteReaction(ctx context.Context, delete *DeleteReaction) error
+}

store/idp.go

@@ -0,0 +1,182 @@
+package store
+
+import (
+	"context"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+)
+
+type IdentityProvider struct {
+	ID               int32
+	Name             string
+	Type             storepb.IdentityProvider_Type
+	IdentifierFilter string
+	Config           string
+}
+
+type FindIdentityProvider struct {
+	ID *int32
+}
+
+type UpdateIdentityProvider struct {
+	ID               int32
+	Name             *string
+	IdentifierFilter *string
+	Config           *string
+}
+
+type DeleteIdentityProvider struct {
+	ID int32
+}
+
+func (s *Store) CreateIdentityProvider(ctx context.Context, create *storepb.IdentityProvider) (*storepb.IdentityProvider, error) {
+	raw, err := convertIdentityProviderToRaw(create)
+	if err != nil {
+		return nil, err
+	}
+	identityProviderRaw, err := s.driver.CreateIdentityProvider(ctx, raw)
+	if err != nil {
+		return nil, err
+	}
+
+	identityProvider, err := convertIdentityProviderFromRaw(identityProviderRaw)
+	if err != nil {
+		return nil, err
+	}
+	return identityProvider, nil
+}
+
+func (s *Store) ListIdentityProviders(ctx context.Context, find *FindIdentityProvider) ([]*storepb.IdentityProvider, error) {
+	list, err := s.driver.ListIdentityProviders(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+
+	identityProviders := []*storepb.IdentityProvider{}
+	for _, raw := range list {
+		identityProvider, err := convertIdentityProviderFromRaw(raw)
+		if err != nil {
+			return nil, err
+		}
+		identityProviders = append(identityProviders, identityProvider)
+	}
+	return identityProviders, nil
+}
+
+func (s *Store) GetIdentityProvider(ctx context.Context, find *FindIdentityProvider) (*storepb.IdentityProvider, error) {
+	list, err := s.ListIdentityProviders(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+	if len(list) == 0 {
+		return nil, nil
+	}
+	if len(list) > 1 {
+		return nil, errors.Errorf("Found multiple identity providers with ID %d", *find.ID)
+	}
+
+	identityProvider := list[0]
+	return identityProvider, nil
+}
+
+type UpdateIdentityProviderV1 struct {
+	ID               int32
+	Type             storepb.IdentityProvider_Type
+	Name             *string
+	IdentifierFilter *string
+	Config           *storepb.IdentityProviderConfig
+}
+
+func (s *Store) UpdateIdentityProvider(ctx context.Context, update *UpdateIdentityProviderV1) (*storepb.IdentityProvider, error) {
+	updateRaw := &UpdateIdentityProvider{
+		ID: update.ID,
+	}
+	if update.Name != nil {
+		updateRaw.Name = update.Name
+	}
+	if update.IdentifierFilter != nil {
+		updateRaw.IdentifierFilter = update.IdentifierFilter
+	}
+	if update.Config != nil {
+		configRaw, err := convertIdentityProviderConfigToRaw(update.Type, update.Config)
+		if err != nil {
+			return nil, err
+		}
+		updateRaw.Config = &configRaw
+	}
+	identityProviderRaw, err := s.driver.UpdateIdentityProvider(ctx, updateRaw)
+	if err != nil {
+		return nil, err
+	}
+
+	identityProvider, err := convertIdentityProviderFromRaw(identityProviderRaw)
+	if err != nil {
+		return nil, err
+	}
+	return identityProvider, nil
+}
+
+func (s *Store) DeleteIdentityProvider(ctx context.Context, delete *DeleteIdentityProvider) error {
+	err := s.driver.DeleteIdentityProvider(ctx, delete)
+	if err != nil {
+		return err
+	}
+	return nil
+}
+
+func convertIdentityProviderFromRaw(raw *IdentityProvider) (*storepb.IdentityProvider, error) {
+	identityProvider := &storepb.IdentityProvider{
+		Id:               raw.ID,
+		Name:             raw.Name,
+		Type:             raw.Type,
+		IdentifierFilter: raw.IdentifierFilter,
+	}
+	config, err := convertIdentityProviderConfigFromRaw(identityProvider.Type, raw.Config)
+	if err != nil {
+		return nil, err
+	}
+	identityProvider.Config = config
+	return identityProvider, nil
+}
+
+func convertIdentityProviderToRaw(identityProvider *storepb.IdentityProvider) (*IdentityProvider, error) {
+	raw := &IdentityProvider{
+		ID:               identityProvider.Id,
+		Name:             identityProvider.Name,
+		Type:             identityProvider.Type,
+		IdentifierFilter: identityProvider.IdentifierFilter,
+	}
+	configRaw, err := convertIdentityProviderConfigToRaw(identityProvider.Type, identityProvider.Config)
+	if err != nil {
+		return nil, err
+	}
+	raw.Config = configRaw
+	return raw, nil
+}
+
+func convertIdentityProviderConfigFromRaw(identityProviderType storepb.IdentityProvider_Type, raw string) (*storepb.IdentityProviderConfig, error) {
+	config := &storepb.IdentityProviderConfig{}
+	if identityProviderType == storepb.IdentityProvider_OAUTH2 {
+		oauth2Config := &storepb.OAuth2Config{}
+		if err := protojsonUnmarshaler.Unmarshal([]byte(raw), oauth2Config); err != nil {
+			return nil, errors.Wrap(err, "Failed to unmarshal OAuth2Config")
+		}
+		config.Config = &storepb.IdentityProviderConfig_Oauth2Config{Oauth2Config: oauth2Config}
+	}
+	return config, nil
+}
+
+func convertIdentityProviderConfigToRaw(identityProviderType storepb.IdentityProvider_Type, config *storepb.IdentityProviderConfig) (string, error) {
+	raw := ""
+	if identityProviderType == storepb.IdentityProvider_OAUTH2 {
+		bytes, err := protojson.Marshal(config.GetOauth2Config())
+		if err != nil {
+			return "", errors.Wrap(err, "Failed to marshal OAuth2Config")
+		}
+		raw = string(bytes)
+	}
+	return raw, nil
+}

store/inbox.go

@@ -0,0 +1,76 @@
+package store
+
+import (
+	"context"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+)
+
+// InboxStatus represents the status of an inbox notification.
+type InboxStatus string
+
+const (
+	// UNREAD indicates the notification has not been read by the user.
+	UNREAD InboxStatus = "UNREAD"
+	// ARCHIVED indicates the notification has been archived/dismissed by the user.
+	ARCHIVED InboxStatus = "ARCHIVED"
+)
+
+func (s InboxStatus) String() string {
+	return string(s)
+}
+
+// Inbox represents a notification in a user's inbox.
+// It connects activities to users who should be notified.
+type Inbox struct {
+	ID         int32
+	CreatedTs  int64
+	SenderID   int32                 // The user who triggered the notification
+	ReceiverID int32                 // The user who receives the notification
+	Status     InboxStatus           // Current status (unread/archived)
+	Message    *storepb.InboxMessage // The notification message content
+}
+
+// UpdateInbox contains fields that can be updated for an inbox item.
+type UpdateInbox struct {
+	ID     int32
+	Status InboxStatus
+}
+
+// FindInbox specifies filter criteria for querying inbox items.
+type FindInbox struct {
+	ID          *int32
+	SenderID    *int32
+	ReceiverID  *int32
+	Status      *InboxStatus
+	MessageType *storepb.InboxMessage_Type
+
+	// Pagination
+	Limit  *int
+	Offset *int
+}
+
+// DeleteInbox specifies which inbox item to delete.
+type DeleteInbox struct {
+	ID int32
+}
+
+// CreateInbox creates a new inbox notification.
+func (s *Store) CreateInbox(ctx context.Context, create *Inbox) (*Inbox, error) {
+	return s.driver.CreateInbox(ctx, create)
+}
+
+// ListInboxes retrieves inbox items matching the filter criteria.
+func (s *Store) ListInboxes(ctx context.Context, find *FindInbox) ([]*Inbox, error) {
+	return s.driver.ListInboxes(ctx, find)
+}
+
+// UpdateInbox updates an existing inbox item.
+func (s *Store) UpdateInbox(ctx context.Context, update *UpdateInbox) (*Inbox, error) {
+	return s.driver.UpdateInbox(ctx, update)
+}
+
+// DeleteInbox permanently removes an inbox item.
+func (s *Store) DeleteInbox(ctx context.Context, delete *DeleteInbox) error {
+	return s.driver.DeleteInbox(ctx, delete)
+}

store/instance_setting.go

@@ -0,0 +1,239 @@
+package store
+
+import (
+	"context"
+
+	"github.com/pkg/errors"
+	"google.golang.org/protobuf/encoding/protojson"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+)
+
+type InstanceSetting struct {
+	Name        string
+	Value       string
+	Description string
+}
+
+type FindInstanceSetting struct {
+	Name string
+}
+
+type DeleteInstanceSetting struct {
+	Name string
+}
+
+func (s *Store) UpsertInstanceSetting(ctx context.Context, upsert *storepb.InstanceSetting) (*storepb.InstanceSetting, error) {
+	instanceSettingRaw := &InstanceSetting{
+		Name: upsert.Key.String(),
+	}
+	var valueBytes []byte
+	var err error
+	if upsert.Key == storepb.InstanceSettingKey_BASIC {
+		valueBytes, err = protojson.Marshal(upsert.GetBasicSetting())
+	} else if upsert.Key == storepb.InstanceSettingKey_GENERAL {
+		valueBytes, err = protojson.Marshal(upsert.GetGeneralSetting())
+	} else if upsert.Key == storepb.InstanceSettingKey_STORAGE {
+		valueBytes, err = protojson.Marshal(upsert.GetStorageSetting())
+	} else if upsert.Key == storepb.InstanceSettingKey_MEMO_RELATED {
+		valueBytes, err = protojson.Marshal(upsert.GetMemoRelatedSetting())
+	} else {
+		return nil, errors.Errorf("unsupported instance setting key: %v", upsert.Key)
+	}
+	if err != nil {
+		return nil, errors.Wrap(err, "failed to marshal instance setting value")
+	}
+	valueString := string(valueBytes)
+	instanceSettingRaw.Value = valueString
+	instanceSettingRaw, err = s.driver.UpsertInstanceSetting(ctx, instanceSettingRaw)
+	if err != nil {
+		return nil, errors.Wrap(err, "Failed to upsert instance setting")
+	}
+	instanceSetting, err := convertInstanceSettingFromRaw(instanceSettingRaw)
+	if err != nil {
+		return nil, errors.Wrap(err, "Failed to convert instance setting")
+	}
+	s.instanceSettingCache.Set(ctx, instanceSetting.Key.String(), instanceSetting)
+	return instanceSetting, nil
+}
+
+func (s *Store) ListInstanceSettings(ctx context.Context, find *FindInstanceSetting) ([]*storepb.InstanceSetting, error) {
+	list, err := s.driver.ListInstanceSettings(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+
+	instanceSettings := []*storepb.InstanceSetting{}
+	for _, instanceSettingRaw := range list {
+		instanceSetting, err := convertInstanceSettingFromRaw(instanceSettingRaw)
+		if err != nil {
+			return nil, errors.Wrap(err, "Failed to convert instance setting")
+		}
+		if instanceSetting == nil {
+			continue
+		}
+		s.instanceSettingCache.Set(ctx, instanceSetting.Key.String(), instanceSetting)
+		instanceSettings = append(instanceSettings, instanceSetting)
+	}
+	return instanceSettings, nil
+}
+
+func (s *Store) GetInstanceSetting(ctx context.Context, find *FindInstanceSetting) (*storepb.InstanceSetting, error) {
+	if cache, ok := s.instanceSettingCache.Get(ctx, find.Name); ok {
+		instanceSetting, ok := cache.(*storepb.InstanceSetting)
+		if ok {
+			return instanceSetting, nil
+		}
+	}
+
+	list, err := s.ListInstanceSettings(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+	if len(list) == 0 {
+		return nil, nil
+	}
+	if len(list) > 1 {
+		return nil, errors.Errorf("found multiple instance settings with key %s", find.Name)
+	}
+	return list[0], nil
+}
+
+func (s *Store) GetInstanceBasicSetting(ctx context.Context) (*storepb.InstanceBasicSetting, error) {
+	instanceSetting, err := s.GetInstanceSetting(ctx, &FindInstanceSetting{
+		Name: storepb.InstanceSettingKey_BASIC.String(),
+	})
+	if err != nil {
+		return nil, errors.Wrap(err, "failed to get instance basic setting")
+	}
+
+	instanceBasicSetting := &storepb.InstanceBasicSetting{}
+	if instanceSetting != nil {
+		instanceBasicSetting = instanceSetting.GetBasicSetting()
+	}
+	s.instanceSettingCache.Set(ctx, storepb.InstanceSettingKey_BASIC.String(), &storepb.InstanceSetting{
+		Key:   storepb.InstanceSettingKey_BASIC,
+		Value: &storepb.InstanceSetting_BasicSetting{BasicSetting: instanceBasicSetting},
+	})
+	return instanceBasicSetting, nil
+}
+
+func (s *Store) GetInstanceGeneralSetting(ctx context.Context) (*storepb.InstanceGeneralSetting, error) {
+	instanceSetting, err := s.GetInstanceSetting(ctx, &FindInstanceSetting{
+		Name: storepb.InstanceSettingKey_GENERAL.String(),
+	})
+	if err != nil {
+		return nil, errors.Wrap(err, "failed to get instance general setting")
+	}
+
+	instanceGeneralSetting := &storepb.InstanceGeneralSetting{}
+	if instanceSetting != nil {
+		instanceGeneralSetting = instanceSetting.GetGeneralSetting()
+	}
+	s.instanceSettingCache.Set(ctx, storepb.InstanceSettingKey_GENERAL.String(), &storepb.InstanceSetting{
+		Key:   storepb.InstanceSettingKey_GENERAL,
+		Value: &storepb.InstanceSetting_GeneralSetting{GeneralSetting: instanceGeneralSetting},
+	})
+	return instanceGeneralSetting, nil
+}
+
+// DefaultContentLengthLimit is the default limit of content length in bytes. 8KB.
+const DefaultContentLengthLimit = 8 * 1024
+
+// DefaultReactions is the default reactions for memo related setting.
+var DefaultReactions = []string{"👍", "👎", "❤️", "🎉", "😄", "😕", "😢", "😡"}
+
+func (s *Store) GetInstanceMemoRelatedSetting(ctx context.Context) (*storepb.InstanceMemoRelatedSetting, error) {
+	instanceSetting, err := s.GetInstanceSetting(ctx, &FindInstanceSetting{
+		Name: storepb.InstanceSettingKey_MEMO_RELATED.String(),
+	})
+	if err != nil {
+		return nil, errors.Wrap(err, "failed to get instance general setting")
+	}
+
+	instanceMemoRelatedSetting := &storepb.InstanceMemoRelatedSetting{}
+	if instanceSetting != nil {
+		instanceMemoRelatedSetting = instanceSetting.GetMemoRelatedSetting()
+	}
+	if instanceMemoRelatedSetting.ContentLengthLimit < DefaultContentLengthLimit {
+		instanceMemoRelatedSetting.ContentLengthLimit = DefaultContentLengthLimit
+	}
+	if len(instanceMemoRelatedSetting.Reactions) == 0 {
+		instanceMemoRelatedSetting.Reactions = append(instanceMemoRelatedSetting.Reactions, DefaultReactions...)
+	}
+	s.instanceSettingCache.Set(ctx, storepb.InstanceSettingKey_MEMO_RELATED.String(), &storepb.InstanceSetting{
+		Key:   storepb.InstanceSettingKey_MEMO_RELATED,
+		Value: &storepb.InstanceSetting_MemoRelatedSetting{MemoRelatedSetting: instanceMemoRelatedSetting},
+	})
+	return instanceMemoRelatedSetting, nil
+}
+
+const (
+	defaultInstanceStorageType       = storepb.InstanceStorageSetting_LOCAL
+	defaultInstanceUploadSizeLimitMb = 30
+	defaultInstanceFilepathTemplate  = "assets/{timestamp}_{filename}"
+)
+
+func (s *Store) GetInstanceStorageSetting(ctx context.Context) (*storepb.InstanceStorageSetting, error) {
+	instanceSetting, err := s.GetInstanceSetting(ctx, &FindInstanceSetting{
+		Name: storepb.InstanceSettingKey_STORAGE.String(),
+	})
+	if err != nil {
+		return nil, errors.Wrap(err, "failed to get instance storage setting")
+	}
+
+	instanceStorageSetting := &storepb.InstanceStorageSetting{}
+	if instanceSetting != nil {
+		instanceStorageSetting = instanceSetting.GetStorageSetting()
+	}
+	if instanceStorageSetting.StorageType == storepb.InstanceStorageSetting_STORAGE_TYPE_UNSPECIFIED {
+		instanceStorageSetting.StorageType = defaultInstanceStorageType
+	}
+	if instanceStorageSetting.UploadSizeLimitMb == 0 {
+		instanceStorageSetting.UploadSizeLimitMb = defaultInstanceUploadSizeLimitMb
+	}
+	if instanceStorageSetting.FilepathTemplate == "" {
+		instanceStorageSetting.FilepathTemplate = defaultInstanceFilepathTemplate
+	}
+	s.instanceSettingCache.Set(ctx, storepb.InstanceSettingKey_STORAGE.String(), &storepb.InstanceSetting{
+		Key:   storepb.InstanceSettingKey_STORAGE,
+		Value: &storepb.InstanceSetting_StorageSetting{StorageSetting: instanceStorageSetting},
+	})
+	return instanceStorageSetting, nil
+}
+
+func convertInstanceSettingFromRaw(instanceSettingRaw *InstanceSetting) (*storepb.InstanceSetting, error) {
+	instanceSetting := &storepb.InstanceSetting{
+		Key: storepb.InstanceSettingKey(storepb.InstanceSettingKey_value[instanceSettingRaw.Name]),
+	}
+	switch instanceSettingRaw.Name {
+	case storepb.InstanceSettingKey_BASIC.String():
+		basicSetting := &storepb.InstanceBasicSetting{}
+		if err := protojsonUnmarshaler.Unmarshal([]byte(instanceSettingRaw.Value), basicSetting); err != nil {
+			return nil, err
+		}
+		instanceSetting.Value = &storepb.InstanceSetting_BasicSetting{BasicSetting: basicSetting}
+	case storepb.InstanceSettingKey_GENERAL.String():
+		generalSetting := &storepb.InstanceGeneralSetting{}
+		if err := protojsonUnmarshaler.Unmarshal([]byte(instanceSettingRaw.Value), generalSetting); err != nil {
+			return nil, err
+		}
+		instanceSetting.Value = &storepb.InstanceSetting_GeneralSetting{GeneralSetting: generalSetting}
+	case storepb.InstanceSettingKey_STORAGE.String():
+		storageSetting := &storepb.InstanceStorageSetting{}
+		if err := protojsonUnmarshaler.Unmarshal([]byte(instanceSettingRaw.Value), storageSetting); err != nil {
+			return nil, err
+		}
+		instanceSetting.Value = &storepb.InstanceSetting_StorageSetting{StorageSetting: storageSetting}
+	case storepb.InstanceSettingKey_MEMO_RELATED.String():
+		memoRelatedSetting := &storepb.InstanceMemoRelatedSetting{}
+		if err := protojsonUnmarshaler.Unmarshal([]byte(instanceSettingRaw.Value), memoRelatedSetting); err != nil {
+			return nil, err
+		}
+		instanceSetting.Value = &storepb.InstanceSetting_MemoRelatedSetting{MemoRelatedSetting: memoRelatedSetting}
+	default:
+		// Skip unsupported instance setting key.
+		return nil, nil
+	}
+	return instanceSetting, nil
+}

store/memo.go

@@ -0,0 +1,159 @@
+package store
+
+import (
+	"context"
+	"errors"
+
+	"github.com/usememos/memos/internal/base"
+
+	storepb "github.com/usememos/memos/proto/gen/store"
+)
+
+// Visibility is the type of a visibility.
+type Visibility string
+
+const (
+	// Public is the PUBLIC visibility.
+	Public Visibility = "PUBLIC"
+	// Protected is the PROTECTED visibility.
+	Protected Visibility = "PROTECTED"
+	// Private is the PRIVATE visibility.
+	Private Visibility = "PRIVATE"
+)
+
+func (v Visibility) String() string {
+	switch v {
+	case Public:
+		return "PUBLIC"
+	case Protected:
+		return "PROTECTED"
+	default:
+		return "PRIVATE"
+	}
+}
+
+type Memo struct {
+	// ID is the system generated unique identifier for the memo.
+	ID int32
+	// UID is the user defined unique identifier for the memo.
+	UID string
+
+	// Standard fields
+	RowStatus RowStatus
+	CreatorID int32
+	CreatedTs int64
+	UpdatedTs int64
+
+	// Domain specific fields
+	Content    string
+	Visibility Visibility
+	Pinned     bool
+	Payload    *storepb.MemoPayload
+
+	// Composed fields
+	ParentUID *string
+}
+
+type FindMemo struct {
+	ID  *int32
+	UID *string
+
+	IDList  []int32
+	UIDList []string
+
+	// Standard fields
+	RowStatus *RowStatus
+	CreatorID *int32
+
+	// Domain specific fields
+	VisibilityList  []Visibility
+	ExcludeContent  bool
+	ExcludeComments bool
+	Filters         []string
+
+	// Pagination
+	Limit  *int
+	Offset *int
+
+	// Ordering
+	OrderByPinned    bool
+	OrderByUpdatedTs bool
+	OrderByTimeAsc   bool
+}
+
+type FindMemoPayload struct {
+	Raw                *string
+	TagSearch          []string
+	HasLink            bool
+	HasTaskList        bool
+	HasCode            bool
+	HasIncompleteTasks bool
+}
+
+type UpdateMemo struct {
+	ID         int32
+	UID        *string
+	CreatedTs  *int64
+	UpdatedTs  *int64
+	RowStatus  *RowStatus
+	Content    *string
+	Visibility *Visibility
+	Pinned     *bool
+	Payload    *storepb.MemoPayload
+}
+
+type DeleteMemo struct {
+	ID int32
+}
+
+func (s *Store) CreateMemo(ctx context.Context, create *Memo) (*Memo, error) {
+	if !base.UIDMatcher.MatchString(create.UID) {
+		return nil, errors.New("invalid uid")
+	}
+	return s.driver.CreateMemo(ctx, create)
+}
+
+func (s *Store) ListMemos(ctx context.Context, find *FindMemo) ([]*Memo, error) {
+	return s.driver.ListMemos(ctx, find)
+}
+
+func (s *Store) GetMemo(ctx context.Context, find *FindMemo) (*Memo, error) {
+	list, err := s.ListMemos(ctx, find)
+	if err != nil {
+		return nil, err
+	}
+	if len(list) == 0 {
+		return nil, nil
+	}
+
+	memo := list[0]
+	return memo, nil
+}
+
+func (s *Store) UpdateMemo(ctx context.Context, update *UpdateMemo) error {
+	if update.UID != nil && !base.UIDMatcher.MatchString(*update.UID) {
+		return errors.New("invalid uid")
+	}
+	return s.driver.UpdateMemo(ctx, update)
+}
+
+func (s *Store) DeleteMemo(ctx context.Context, delete *DeleteMemo) error {
+	// Clean up memo_relation records where this memo is either the source or target.
+	if err := s.driver.DeleteMemoRelation(ctx, &DeleteMemoRelation{MemoID: &delete.ID}); err != nil {
+		return err
+	}
+	if err := s.driver.DeleteMemoRelation(ctx, &DeleteMemoRelation{RelatedMemoID: &delete.ID}); err != nil {
+		return err
+	}
+	// Clean up attachments linked to this memo.
+	attachments, err := s.ListAttachments(ctx, &FindAttachment{MemoID: &delete.ID})
+	if err != nil {
+		return err
+	}
+	for _, attachment := range attachments {
+		if err := s.DeleteAttachment(ctx, &DeleteAttachment{ID: attachment.ID}); err != nil {
+			return err
+		}
+	}
+	return s.driver.DeleteMemo(ctx, delete)
+}

store/memo_relation.go

@@ -0,0 +1,45 @@
+package store
+
+import (
+	"context"
+)
+
+type MemoRelationType string
+
+const (
+	// MemoRelationReference is the type for a reference memo relation.
+	MemoRelationReference MemoRelationType = "REFERENCE"
+	// MemoRelationComment is the type for a comment memo relation.
+	MemoRelationComment MemoRelationType = "COMMENT"
+)
+
+type MemoRelation struct {
+	MemoID        int32
+	RelatedMemoID int32
+	Type          MemoRelationType
+}
+
+type FindMemoRelation struct {
+	MemoID        *int32
+	RelatedMemoID *int32
+	Type          *MemoRelationType
+	MemoFilter    *string
+}
+
+type DeleteMemoRelation struct {
+	MemoID        *int32
+	RelatedMemoID *int32
+	Type          *MemoRelationType
+}
+
+func (s *Store) UpsertMemoRelation(ctx context.Context, create *MemoRelation) (*MemoRelation, error) {
+	return s.driver.UpsertMemoRelation(ctx, create)
+}
+
+func (s *Store) ListMemoRelations(ctx context.Context, find *FindMemoRelation) ([]*MemoRelation, error) {
+	return s.driver.ListMemoRelations(ctx, find)
+}
+
+func (s *Store) DeleteMemoRelation(ctx context.Context, delete *DeleteMemoRelation) error {
+	return s.driver.DeleteMemoRelation(ctx, delete)
+}

store/migration/mysql/0.17/00__inbox.sql

@@ -0,0 +1,9 @@
+-- inbox
+CREATE TABLE `inbox` (
+  `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  `created_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `sender_id` INT NOT NULL,
+  `receiver_id` INT NOT NULL,
+  `status` TEXT NOT NULL,
+  `message` TEXT NOT NULL
+);

store/migration/mysql/0.17/01__delete_activity.sql

@@ -0,0 +1 @@
+DELETE FROM `activity`;

store/migration/mysql/0.18/00__extend_text.sql

@@ -0,0 +1,3 @@
+ALTER TABLE `system_setting` MODIFY `value` LONGTEXT NOT NULL;
+ALTER TABLE `user_setting` MODIFY `value` LONGTEXT NOT NULL;
+ALTER TABLE `user` MODIFY `avatar_url` LONGTEXT NOT NULL;

store/migration/mysql/0.18/01__webhook.sql

@@ -0,0 +1,10 @@
+-- webhook
+CREATE TABLE `webhook` (
+  `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  `created_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `row_status` VARCHAR(256) NOT NULL DEFAULT 'NORMAL',
+  `creator_id` INT NOT NULL,
+  `name` TEXT NOT NULL,
+  `url` TEXT NOT NULL
+);

store/migration/mysql/0.18/02__user_setting.sql

@@ -0,0 +1,4 @@
+UPDATE `user_setting` SET `key` = 'USER_SETTING_LOCALE', `value` = REPLACE(`value`, '"', '') WHERE `key` = 'locale';
+UPDATE `user_setting` SET `key` = 'USER_SETTING_APPEARANCE', `value` = REPLACE(`value`, '"', '') WHERE `key` = 'appearance';
+UPDATE `user_setting` SET `key` = 'USER_SETTING_MEMO_VISIBILITY', `value` = REPLACE(`value`, '"', '') WHERE `key` = 'memo-visibility';
+UPDATE `user_setting` SET `key` = 'USER_SETTING_TELEGRAM_USER_ID', `value` = REPLACE(`value`, '"', '') WHERE `key` = 'telegram-user-id';

store/migration/mysql/0.19/00__add_resource_name.sql

@@ -0,0 +1,15 @@
+ALTER TABLE `memo` ADD COLUMN `resource_name` VARCHAR(256) AFTER `id`;
+
+UPDATE `memo` SET `resource_name` = uuid();
+
+ALTER TABLE `memo` MODIFY COLUMN `resource_name` VARCHAR(256) NOT NULL;
+
+CREATE UNIQUE INDEX idx_memo_resource_name ON `memo` (`resource_name`);
+
+ALTER TABLE `resource` ADD COLUMN `resource_name` VARCHAR(256) AFTER `id`;
+
+UPDATE `resource` SET `resource_name` = uuid();
+
+ALTER TABLE `resource` MODIFY COLUMN `resource_name` VARCHAR(256) NOT NULL;
+
+CREATE UNIQUE INDEX idx_resource_resource_name ON `resource` (`resource_name`);

store/migration/mysql/0.20/00__reaction.sql

@@ -0,0 +1,9 @@
+-- reaction
+CREATE TABLE `reaction` (
+  `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  `created_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `creator_id` INT NOT NULL,
+  `content_id` VARCHAR(256) NOT NULL,
+  `reaction_type` VARCHAR(256) NOT NULL,
+  UNIQUE(`creator_id`,`content_id`,`reaction_type`)  
+);

store/migration/mysql/0.21/00__user_description.sql

@@ -0,0 +1 @@
+ALTER TABLE `user` ADD COLUMN `description` VARCHAR(256) NOT NULL DEFAULT '';

store/migration/mysql/0.21/01__rename_uid.sql

@@ -0,0 +1,3 @@
+ALTER TABLE `memo` RENAME COLUMN `resource_name` TO `uid`;
+
+ALTER TABLE `resource` RENAME COLUMN `resource_name` TO `uid`;

store/migration/mysql/0.22/00__resource_storage_type.sql

@@ -0,0 +1,11 @@
+ALTER TABLE `resource` ADD COLUMN `storage_type` VARCHAR(256) NOT NULL DEFAULT '';
+ALTER TABLE `resource` ADD COLUMN `reference` VARCHAR(256) NOT NULL DEFAULT '';
+ALTER TABLE `resource` ADD COLUMN `payload` TEXT NOT NULL;
+
+UPDATE `resource` SET `payload` = '{}';
+
+UPDATE `resource` SET `storage_type` = 'LOCAL', `reference` = `internal_path` WHERE `internal_path` IS NOT NULL AND `internal_path` != '';
+UPDATE `resource` SET `storage_type` = 'EXTERNAL', `reference` = `external_link` WHERE `external_link` IS NOT NULL AND `external_link` != '';
+
+ALTER TABLE `resource` DROP COLUMN `internal_path`;
+ALTER TABLE `resource` DROP COLUMN `external_link`;

store/migration/mysql/0.22/01__memo_tags.sql

@@ -0,0 +1,3 @@
+ALTER TABLE `memo` ADD COLUMN `tags_temp` JSON;
+UPDATE `memo` SET `tags_temp` = '[]';
+ALTER TABLE `memo` CHANGE COLUMN `tags_temp` `tags` JSON NOT NULL;

store/migration/mysql/0.22/02__memo_payload.sql

@@ -0,0 +1,3 @@
+ALTER TABLE `memo` ADD COLUMN `payload_temp` JSON;
+UPDATE `memo` SET `payload_temp` = '{}';
+ALTER TABLE `memo` CHANGE COLUMN `payload_temp` `payload` JSON NOT NULL;

store/migration/mysql/0.22/03__drop_tag.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS `tag`;

store/migration/mysql/0.23/00__reactions.sql

@@ -0,0 +1,12 @@
+UPDATE `reaction` SET `reaction_type` = '👍' WHERE `reaction_type` = 'THUMBS_UP';
+UPDATE `reaction` SET `reaction_type` = '👎' WHERE `reaction_type` = 'THUMBS_DOWN';
+UPDATE `reaction` SET `reaction_type` = '💛' WHERE `reaction_type` = 'HEART';
+UPDATE `reaction` SET `reaction_type` = '🔥' WHERE `reaction_type` = 'FIRE';
+UPDATE `reaction` SET `reaction_type` = '👏' WHERE `reaction_type` = 'CLAPPING_HANDS';
+UPDATE `reaction` SET `reaction_type` = '😂' WHERE `reaction_type` = 'LAUGH';
+UPDATE `reaction` SET `reaction_type` = '👌' WHERE `reaction_type` = 'OK_HAND';
+UPDATE `reaction` SET `reaction_type` = '🚀' WHERE `reaction_type` = 'ROCKET';
+UPDATE `reaction` SET `reaction_type` = '👀' WHERE `reaction_type` = 'EYES';
+UPDATE `reaction` SET `reaction_type` = '🤔' WHERE `reaction_type` = 'THINKING_FACE';
+UPDATE `reaction` SET `reaction_type` = '🤡' WHERE `reaction_type` = 'CLOWN_FACE';
+UPDATE `reaction` SET `reaction_type` = '❓' WHERE `reaction_type` = 'QUESTION_MARK';

store/migration/mysql/0.24/00__memo.sql

@@ -0,0 +1,2 @@
+-- Drop deprecated tags column.
+ALTER TABLE `memo` DROP COLUMN `tags`;

store/migration/mysql/0.24/01__memo_pinned.sql

@@ -0,0 +1,8 @@
+-- Add pinned column.
+ALTER TABLE `memo` ADD COLUMN `pinned` BOOLEAN NOT NULL DEFAULT FALSE;
+
+-- Update pinned column from memo_organizer.
+UPDATE memo
+JOIN memo_organizer ON memo.id = memo_organizer.memo_id
+SET memo.pinned = TRUE
+WHERE memo_organizer.pinned = 1;

store/migration/mysql/0.24/02__s3_reference_length.sql

@@ -0,0 +1,2 @@
+-- https://github.com/usememos/memos/issues/4322
+ALTER TABLE `resource` MODIFY `reference` TEXT NOT NULL DEFAULT ('');

store/migration/mysql/0.25/00__remove_webhook.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS webhook;

store/migration/mysql/0.26/00__rename_resource_to_attachment.sql

@@ -0,0 +1 @@
+RENAME TABLE resource TO attachment;

store/migration/mysql/0.26/01__drop_memo_organizer.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS memo_organizer;

store/migration/mysql/0.26/02__migrate_host_to_admin.sql

@@ -0,0 +1 @@
+UPDATE `user` SET `role` = 'ADMIN' WHERE `role` = 'HOST';

store/migration/mysql/0.26/03__migrate_storage_setting.sql

@@ -0,0 +1,6 @@
+-- Set storage type to DATABASE for existing instances that have no storage setting configured.
+-- This preserves backward-compatible behavior before the default was changed to LOCAL.
+INSERT INTO system_setting (name, value, description)
+SELECT 'STORAGE', '{"storageType":"DATABASE"}', ''
+FROM DUAL
+WHERE NOT EXISTS (SELECT 1 FROM system_setting WHERE name = 'STORAGE');

store/migration/mysql/LATEST.sql

@@ -0,0 +1,107 @@
+-- system_setting
+CREATE TABLE `system_setting` (
+  `name` VARCHAR(256) NOT NULL PRIMARY KEY,
+  `value` LONGTEXT NOT NULL,
+  `description` TEXT NOT NULL
+);
+
+-- user
+CREATE TABLE `user` (
+  `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  `created_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `row_status` VARCHAR(256) NOT NULL DEFAULT 'NORMAL',
+  `username` VARCHAR(256) NOT NULL UNIQUE,
+  `role` VARCHAR(256) NOT NULL DEFAULT 'USER',
+  `email` VARCHAR(256) NOT NULL DEFAULT '',
+  `nickname` VARCHAR(256) NOT NULL DEFAULT '',
+  `password_hash` VARCHAR(256) NOT NULL,
+  `avatar_url` LONGTEXT NOT NULL,
+  `description` VARCHAR(256) NOT NULL DEFAULT ''
+);
+
+-- user_setting
+CREATE TABLE `user_setting` (
+  `user_id` INT NOT NULL,
+  `key` VARCHAR(256) NOT NULL,
+  `value` LONGTEXT NOT NULL,
+  UNIQUE(`user_id`,`key`)
+);
+
+-- memo
+CREATE TABLE `memo` (
+  `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  `uid` VARCHAR(256) NOT NULL UNIQUE,
+  `creator_id` INT NOT NULL,
+  `created_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `row_status` VARCHAR(256) NOT NULL DEFAULT 'NORMAL',
+  `content` TEXT NOT NULL,
+  `visibility` VARCHAR(256) NOT NULL DEFAULT 'PRIVATE',
+  `pinned` BOOLEAN NOT NULL DEFAULT FALSE,
+  `payload` JSON NOT NULL
+);
+
+-- memo_relation
+CREATE TABLE `memo_relation` (
+  `memo_id` INT NOT NULL,
+  `related_memo_id` INT NOT NULL,
+  `type` VARCHAR(256) NOT NULL,
+  UNIQUE(`memo_id`,`related_memo_id`,`type`)
+);
+
+-- attachment
+CREATE TABLE `attachment` (
+  `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  `uid` VARCHAR(256) NOT NULL UNIQUE,
+  `creator_id` INT NOT NULL,
+  `created_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `filename` TEXT NOT NULL,
+  `blob` MEDIUMBLOB,
+  `type` VARCHAR(256) NOT NULL DEFAULT '',
+  `size` INT NOT NULL DEFAULT '0',
+  `memo_id` INT DEFAULT NULL,
+  `storage_type` VARCHAR(256) NOT NULL DEFAULT '',
+  `reference` TEXT NOT NULL DEFAULT (''),
+  `payload` TEXT NOT NULL
+);
+
+-- activity
+CREATE TABLE `activity` (
+  `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  `creator_id` INT NOT NULL,
+  `created_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `type` VARCHAR(256) NOT NULL DEFAULT '',
+  `level` VARCHAR(256) NOT NULL DEFAULT 'INFO',
+  `payload` TEXT NOT NULL
+);
+
+-- idp
+CREATE TABLE `idp` (
+  `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  `name` TEXT NOT NULL,
+  `type` TEXT NOT NULL,
+  `identifier_filter` VARCHAR(256) NOT NULL DEFAULT '',
+  `config` TEXT NOT NULL
+);
+
+-- inbox
+CREATE TABLE `inbox` (
+  `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  `created_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `sender_id` INT NOT NULL,
+  `receiver_id` INT NOT NULL,
+  `status` TEXT NOT NULL,
+  `message` TEXT NOT NULL
+);
+
+-- reaction
+CREATE TABLE `reaction` (
+  `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  `created_ts` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `creator_id` INT NOT NULL,
+  `content_id` VARCHAR(256) NOT NULL,
+  `reaction_type` VARCHAR(256) NOT NULL,
+  UNIQUE(`creator_id`,`content_id`,`reaction_type`)  
+);

store/migration/postgres/0.19/00__add_resource_name.sql

@@ -0,0 +1,15 @@
+ALTER TABLE memo ADD COLUMN resource_name TEXT;
+
+UPDATE memo SET resource_name = uuid_in(md5(random()::text || random()::text)::cstring);
+
+ALTER TABLE memo ALTER COLUMN resource_name SET NOT NULL;
+
+CREATE UNIQUE INDEX idx_memo_resource_name ON memo (resource_name);
+
+ALTER TABLE resource ADD COLUMN resource_name TEXT;
+
+UPDATE resource SET resource_name = uuid_in(md5(random()::text || random()::text)::cstring);
+
+ALTER TABLE resource ALTER COLUMN resource_name SET NOT NULL;
+
+CREATE UNIQUE INDEX idx_resource_resource_name ON resource (resource_name);

store/migration/postgres/0.20/00__reaction.sql

@@ -0,0 +1,9 @@
+-- reaction
+CREATE TABLE reaction (
+  id SERIAL PRIMARY KEY,
+  created_ts BIGINT NOT NULL DEFAULT EXTRACT(EPOCH FROM NOW()),
+  creator_id INTEGER NOT NULL,
+  content_id TEXT NOT NULL,
+  reaction_type TEXT NOT NULL,
+  UNIQUE(creator_id, content_id, reaction_type)
+);

store/migration/postgres/0.21/00__user_description.sql

@@ -0,0 +1 @@
+ALTER TABLE "user" ADD COLUMN description TEXT NOT NULL DEFAULT '';

store/migration/postgres/0.21/01__rename_uid.sql

@@ -0,0 +1,3 @@
+ALTER TABLE memo RENAME COLUMN resource_name TO uid;
+
+ALTER TABLE resource RENAME COLUMN resource_name TO uid;

store/migration/postgres/0.22/00__resource_storage_type.sql

@@ -0,0 +1,11 @@
+ALTER TABLE resource ADD COLUMN storage_type TEXT NOT NULL DEFAULT '';
+ALTER TABLE resource ADD COLUMN reference TEXT NOT NULL DEFAULT '';
+ALTER TABLE resource ADD COLUMN payload TEXT NOT NULL DEFAULT '{}';
+
+UPDATE resource SET storage_type = 'LOCAL', reference = internal_path WHERE internal_path IS NOT NULL AND internal_path != '';
+
+UPDATE resource SET storage_type = 'EXTERNAL', reference = external_link WHERE external_link IS NOT NULL AND external_link != '';
+
+ALTER TABLE resource DROP COLUMN internal_path;
+
+ALTER TABLE resource DROP COLUMN external_link;

store/migration/postgres/0.22/01__memo_tags.sql

@@ -0,0 +1 @@
+ALTER TABLE memo ADD COLUMN tags JSONB NOT NULL DEFAULT '[]';

store/migration/postgres/0.22/02__memo_payload.sql

@@ -0,0 +1 @@
+ALTER TABLE memo ADD COLUMN payload JSONB NOT NULL DEFAULT '{}';

store/migration/postgres/0.22/03__drop_tag.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS tag;

store/migration/postgres/0.23/00__reactions.sql

@@ -0,0 +1,12 @@
+UPDATE "reaction" SET "reaction_type" = '👍' WHERE "reaction_type" = 'THUMBS_UP';
+UPDATE "reaction" SET "reaction_type" = '👎' WHERE "reaction_type" = 'THUMBS_DOWN';
+UPDATE "reaction" SET "reaction_type" = '💛' WHERE "reaction_type" = 'HEART';
+UPDATE "reaction" SET "reaction_type" = '🔥' WHERE "reaction_type" = 'FIRE';
+UPDATE "reaction" SET "reaction_type" = '👏' WHERE "reaction_type" = 'CLAPPING_HANDS';
+UPDATE "reaction" SET "reaction_type" = '😂' WHERE "reaction_type" = 'LAUGH';
+UPDATE "reaction" SET "reaction_type" = '👌' WHERE "reaction_type" = 'OK_HAND';
+UPDATE "reaction" SET "reaction_type" = '🚀' WHERE "reaction_type" = 'ROCKET';
+UPDATE "reaction" SET "reaction_type" = '👀' WHERE "reaction_type" = 'EYES';
+UPDATE "reaction" SET "reaction_type" = '🤔' WHERE "reaction_type" = 'THINKING_FACE';
+UPDATE "reaction" SET "reaction_type" = '🤡' WHERE "reaction_type" = 'CLOWN_FACE';
+UPDATE "reaction" SET "reaction_type" = '❓' WHERE "reaction_type" = 'QUESTION_MARK';

store/migration/postgres/0.24/00__memo.sql

@@ -0,0 +1,2 @@
+-- Drop deprecated tags column.
+ALTER TABLE memo DROP COLUMN IF EXISTS tags;

store/migration/postgres/0.24/01__memo_pinned.sql

@@ -0,0 +1,8 @@
+-- Add pinned column.
+ALTER TABLE memo ADD COLUMN pinned BOOLEAN NOT NULL DEFAULT FALSE;
+
+-- Update pinned column from memo_organizer.
+UPDATE memo
+SET pinned = TRUE
+FROM memo_organizer
+WHERE memo.id = memo_organizer.memo_id AND memo_organizer.pinned = 1;

store/migration/postgres/0.25/00__remove_webhook.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS webhook;

store/migration/postgres/0.26/00__rename_resource_to_attachment.sql

@@ -0,0 +1 @@
+ALTER TABLE resource RENAME TO attachment;

store/migration/postgres/0.26/01__drop_memo_organizer.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS memo_organizer;

store/migration/postgres/0.26/02__migrate_host_to_admin.sql

@@ -0,0 +1 @@
+UPDATE "user" SET role = 'ADMIN' WHERE role = 'HOST';

store/migration/postgres/0.26/03__migrate_storage_setting.sql

@@ -0,0 +1,5 @@
+-- Set storage type to DATABASE for existing instances that have no storage setting configured.
+-- This preserves backward-compatible behavior before the default was changed to LOCAL.
+INSERT INTO system_setting (name, value, description)
+SELECT 'STORAGE', '{"storageType":"DATABASE"}', ''
+WHERE NOT EXISTS (SELECT 1 FROM system_setting WHERE name = 'STORAGE');

store/migration/postgres/LATEST.sql

@@ -0,0 +1,107 @@
+-- system_setting
+CREATE TABLE system_setting (
+  name TEXT NOT NULL PRIMARY KEY,
+  value TEXT NOT NULL,
+  description TEXT NOT NULL
+);
+
+-- user
+CREATE TABLE "user" (
+  id SERIAL PRIMARY KEY,
+  created_ts BIGINT NOT NULL DEFAULT EXTRACT(EPOCH FROM NOW()),
+  updated_ts BIGINT NOT NULL DEFAULT EXTRACT(EPOCH FROM NOW()),
+  row_status TEXT NOT NULL DEFAULT 'NORMAL',
+  username TEXT NOT NULL UNIQUE,
+  role TEXT NOT NULL DEFAULT 'USER',
+  email TEXT NOT NULL DEFAULT '',
+  nickname TEXT NOT NULL DEFAULT '',
+  password_hash TEXT NOT NULL,
+  avatar_url TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT ''
+);
+
+-- user_setting
+CREATE TABLE user_setting (
+  user_id INTEGER NOT NULL,
+  key TEXT NOT NULL,
+  value TEXT NOT NULL,
+  UNIQUE(user_id, key)
+);
+
+-- memo
+CREATE TABLE memo (
+  id SERIAL PRIMARY KEY,
+  uid TEXT NOT NULL UNIQUE,
+  creator_id INTEGER NOT NULL,
+  created_ts BIGINT NOT NULL DEFAULT EXTRACT(EPOCH FROM NOW()),
+  updated_ts BIGINT NOT NULL DEFAULT EXTRACT(EPOCH FROM NOW()),
+  row_status TEXT NOT NULL DEFAULT 'NORMAL',
+  content TEXT NOT NULL,
+  visibility TEXT NOT NULL DEFAULT 'PRIVATE',
+  pinned BOOLEAN NOT NULL DEFAULT FALSE,
+  payload JSONB NOT NULL DEFAULT '{}'
+);
+
+-- memo_relation
+CREATE TABLE memo_relation (
+  memo_id INTEGER NOT NULL,
+  related_memo_id INTEGER NOT NULL,
+  type TEXT NOT NULL,
+  UNIQUE(memo_id, related_memo_id, type)
+);
+
+-- attachment
+CREATE TABLE attachment (
+  id SERIAL PRIMARY KEY,
+  uid TEXT NOT NULL UNIQUE,
+  creator_id INTEGER NOT NULL,
+  created_ts BIGINT NOT NULL DEFAULT EXTRACT(EPOCH FROM NOW()),
+  updated_ts BIGINT NOT NULL DEFAULT EXTRACT(EPOCH FROM NOW()),
+  filename TEXT NOT NULL,
+  blob BYTEA,
+  type TEXT NOT NULL DEFAULT '',
+  size INTEGER NOT NULL DEFAULT 0,
+  memo_id INTEGER DEFAULT NULL,
+  storage_type TEXT NOT NULL DEFAULT '',
+  reference TEXT NOT NULL DEFAULT '',
+  payload TEXT NOT NULL DEFAULT '{}'
+);
+
+-- activity
+CREATE TABLE activity (
+  id SERIAL PRIMARY KEY,
+  creator_id INTEGER NOT NULL,
+  created_ts BIGINT NOT NULL DEFAULT EXTRACT(EPOCH FROM NOW()),
+  type TEXT NOT NULL DEFAULT '',
+  level TEXT NOT NULL DEFAULT 'INFO',
+  payload JSONB NOT NULL DEFAULT '{}'
+);
+
+-- idp
+CREATE TABLE idp (
+  id SERIAL PRIMARY KEY,
+  name TEXT NOT NULL,
+  type TEXT NOT NULL,
+  identifier_filter TEXT NOT NULL DEFAULT '',
+  config JSONB NOT NULL DEFAULT '{}'
+);
+
+-- inbox
+CREATE TABLE inbox (
+  id SERIAL PRIMARY KEY,
+  created_ts BIGINT NOT NULL DEFAULT EXTRACT(EPOCH FROM NOW()),
+  sender_id INTEGER NOT NULL,
+  receiver_id INTEGER NOT NULL,
+  status TEXT NOT NULL,
+  message TEXT NOT NULL
+);
+
+-- reaction
+CREATE TABLE reaction (
+  id SERIAL PRIMARY KEY,
+  created_ts BIGINT NOT NULL DEFAULT EXTRACT(EPOCH FROM NOW()),
+  creator_id INTEGER NOT NULL,
+  content_id TEXT NOT NULL,
+  reaction_type TEXT NOT NULL,
+  UNIQUE(creator_id, content_id, reaction_type)
+);

store/migration/sqlite/0.10/00__activity.sql

@@ -0,0 +1,9 @@
+-- activity
+CREATE TABLE activity (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  creator_id INTEGER NOT NULL,
+  created_ts BIGINT NOT NULL DEFAULT (strftime('%s', 'now')),
+  type TEXT NOT NULL DEFAULT '',
+  level TEXT NOT NULL CHECK (level IN ('INFO', 'WARN', 'ERROR')) DEFAULT 'INFO',
+  payload TEXT NOT NULL DEFAULT '{}'
+);

store/migration/sqlite/0.11/00__user_avatar.sql

@@ -0,0 +1,4 @@
+ALTER TABLE
+  user
+ADD
+  COLUMN avatar_url TEXT NOT NULL DEFAULT '';

store/migration/sqlite/0.11/01__idp.sql

@@ -0,0 +1,8 @@
+-- idp
+CREATE TABLE idp (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL,
+  type TEXT NOT NULL,
+  identifier_filter TEXT NOT NULL DEFAULT '',
+  config TEXT NOT NULL DEFAULT '{}'
+);

store/migration/sqlite/0.11/02__storage.sql

@@ -0,0 +1,7 @@
+-- storage
+CREATE TABLE storage (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL,
+  type TEXT NOT NULL,
+  config TEXT NOT NULL DEFAULT '{}'
+);

store/migration/sqlite/0.12/00__user_setting.sql

@@ -0,0 +1,6 @@
+UPDATE
+  user_setting
+SET
+  key = 'memo-visibility'
+WHERE
+  key = 'memoVisibility';

store/migration/sqlite/0.12/01__system_setting.sql

@@ -0,0 +1,69 @@
+UPDATE
+  system_setting
+SET
+  name = 'server-id'
+WHERE
+  name = 'serverId';
+
+UPDATE
+  system_setting
+SET
+  name = 'secret-session'
+WHERE
+  name = 'secretSessionName';
+
+UPDATE
+  system_setting
+SET
+  name = 'allow-signup'
+WHERE
+  name = 'allowSignUp';
+
+UPDATE
+  system_setting
+SET
+  name = 'disable-public-memos'
+WHERE
+  name = 'disablePublicMemos';
+
+UPDATE
+  system_setting
+SET
+  name = 'additional-style'
+WHERE
+  name = 'additionalStyle';
+
+UPDATE
+  system_setting
+SET
+  name = 'additional-script'
+WHERE
+  name = 'additionalScript';
+
+UPDATE
+  system_setting
+SET
+  name = 'customized-profile'
+WHERE
+  name = 'customizedProfile';
+
+UPDATE
+  system_setting
+SET
+  name = 'storage-service-id'
+WHERE
+  name = 'storageServiceId';
+
+UPDATE
+  system_setting
+SET
+  name = 'local-storage-path'
+WHERE
+  name = 'localStoragePath';
+
+UPDATE
+  system_setting
+SET
+  name = 'openai-config'
+WHERE
+  name = 'openAIConfig';

store/migration/sqlite/0.12/03__resource_internal_path.sql

@@ -0,0 +1,4 @@
+ALTER TABLE
+  resource
+ADD
+  COLUMN internal_path TEXT NOT NULL DEFAULT '';

store/migration/sqlite/0.12/04__resource_public_id.sql

@@ -0,0 +1,18 @@
+ALTER TABLE
+  resource
+ADD
+  COLUMN public_id TEXT NOT NULL DEFAULT '';
+
+CREATE UNIQUE INDEX resource_id_public_id_unique_index ON resource (id, public_id);
+
+UPDATE
+  resource
+SET
+  public_id = printf (
+    '%s-%s-%s-%s-%s',
+    lower(hex(randomblob(4))),
+    lower(hex(randomblob(2))),
+    lower(hex(randomblob(2))),
+    lower(hex(randomblob(2))),
+    lower(hex(randomblob(6)))
+  );

store/migration/sqlite/0.13/00__memo_relation.sql

@@ -0,0 +1,7 @@
+-- memo_relation
+CREATE TABLE memo_relation (
+  memo_id INTEGER NOT NULL,
+  related_memo_id INTEGER NOT NULL,
+  type TEXT NOT NULL,
+  UNIQUE(memo_id, related_memo_id, type)
+);