Files
kandev/apps/backend/internal/plugins/state/store_test.go
T
2026-08-24 11:09:03 +00:00

334 lines
11 KiB
Go

package state
import (
"context"
"encoding/json"
"testing"
"time"
"github.com/jmoiron/sqlx"
_ "github.com/mattn/go-sqlite3"
"github.com/kandev/kandev/internal/db"
)
func TestStoreSetThenGetReturnsStoredValue(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
value := json.RawMessage(`{"synced":true}`)
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_xyz", "sync_status", value); err != nil {
t.Fatalf("set: %v", err)
}
got, found, err := store.Get(ctx, "kandev-plugin-jira", "task", "task_xyz", "sync_status")
if err != nil {
t.Fatalf("get: %v", err)
}
if !found {
t.Fatalf("expected found = true")
}
if string(got) != string(value) {
t.Fatalf("got %q, want %q", got, value)
}
}
func TestStoreGetMissingReturnsNotFound(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
got, found, err := store.Get(ctx, "kandev-plugin-jira", "task", "task_xyz", "missing_key")
if err != nil {
t.Fatalf("get: %v", err)
}
if found || got != nil {
t.Fatalf("got (%q, %v), want (nil, false)", got, found)
}
}
// TestStoreSetUpsertsOnRepeatedWrite pins the UNIQUE(plugin_id, scope,
// scope_id, state_key) upsert contract: a second Set for the same tuple must
// update the existing row in place, not create a duplicate.
func TestStoreSetUpsertsOnRepeatedWrite(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_xyz", "sync_status", json.RawMessage(`"PROJ-1"`)); err != nil {
t.Fatalf("first set: %v", err)
}
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_xyz", "sync_status", json.RawMessage(`"PROJ-2"`)); err != nil {
t.Fatalf("second set: %v", err)
}
got, found, err := store.Get(ctx, "kandev-plugin-jira", "task", "task_xyz", "sync_status")
if err != nil {
t.Fatalf("get: %v", err)
}
if !found {
t.Fatalf("expected found = true")
}
if string(got) != `"PROJ-2"` {
t.Fatalf("got %q, want %q (upsert should overwrite)", got, `"PROJ-2"`)
}
entries, err := store.List(ctx, "kandev-plugin-jira", "task", "task_xyz")
if err != nil {
t.Fatalf("list: %v", err)
}
if len(entries) != 1 {
t.Fatalf("expected exactly 1 entry after repeated Set, got %d: %+v", len(entries), entries)
}
}
// TestStoreInstanceScopeUpsertsWithEmptyScopeID pins scope_id NULL handling
// for instance-scoped state (scope_id == ""). SQLite's UNIQUE index treats
// each NULL as distinct, so a naive INSERT ... ON CONFLICT with a literal
// NULL scope_id would silently insert a duplicate row on the second Set
// instead of updating. The store must normalize "" consistently so repeated
// writes at instance scope still upsert.
func TestStoreInstanceScopeUpsertsWithEmptyScopeID(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
if err := store.Set(ctx, "kandev-plugin-jira", "instance", "", "install_id", json.RawMessage(`"abc"`)); err != nil {
t.Fatalf("first set: %v", err)
}
if err := store.Set(ctx, "kandev-plugin-jira", "instance", "", "install_id", json.RawMessage(`"def"`)); err != nil {
t.Fatalf("second set: %v", err)
}
got, found, err := store.Get(ctx, "kandev-plugin-jira", "instance", "", "install_id")
if err != nil {
t.Fatalf("get: %v", err)
}
if !found || string(got) != `"def"` {
t.Fatalf("got (%q, %v), want (\"def\", true)", got, found)
}
entries, err := store.List(ctx, "kandev-plugin-jira", "instance", "")
if err != nil {
t.Fatalf("list: %v", err)
}
if len(entries) != 1 {
t.Fatalf("expected exactly 1 instance-scoped entry, got %d: %+v", len(entries), entries)
}
}
func TestStoreDeleteRemovesEntry(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_xyz", "sync_status", json.RawMessage(`"PROJ-1"`)); err != nil {
t.Fatalf("set: %v", err)
}
if err := store.Delete(ctx, "kandev-plugin-jira", "task", "task_xyz", "sync_status"); err != nil {
t.Fatalf("delete: %v", err)
}
_, found, err := store.Get(ctx, "kandev-plugin-jira", "task", "task_xyz", "sync_status")
if err != nil {
t.Fatalf("get after delete: %v", err)
}
if found {
t.Fatalf("expected not found after delete")
}
}
// TestStoreDeleteAllRemovesEveryRowForPlugin pins the Uninstall cleanup
// contract (docs/specs/plugins/requirements/plugins.md "plugin_state"): a plugin's entire
// state footprint — across every scope and scope_id — must be removable in
// one call, so a reinstalled or id-reused plugin never inherits stale state.
func TestStoreDeleteAllRemovesEveryRowForPlugin(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
if err := store.Set(ctx, "kandev-plugin-jira", "instance", "", "install_id", json.RawMessage(`"abc"`)); err != nil {
t.Fatalf("set instance-scoped: %v", err)
}
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_1", "sync_status", json.RawMessage(`"PROJ-1"`)); err != nil {
t.Fatalf("set task_1-scoped: %v", err)
}
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_2", "sync_status", json.RawMessage(`"PROJ-2"`)); err != nil {
t.Fatalf("set task_2-scoped: %v", err)
}
if err := store.DeleteAll(ctx, "kandev-plugin-jira"); err != nil {
t.Fatalf("DeleteAll: %v", err)
}
if entries, err := store.List(ctx, "kandev-plugin-jira", "instance", ""); err != nil || len(entries) != 0 {
t.Fatalf("instance-scoped entries after DeleteAll = %v (err=%v), want none", entries, err)
}
if entries, err := store.List(ctx, "kandev-plugin-jira", "task", "task_1"); err != nil || len(entries) != 0 {
t.Fatalf("task_1-scoped entries after DeleteAll = %v (err=%v), want none", entries, err)
}
if entries, err := store.List(ctx, "kandev-plugin-jira", "task", "task_2"); err != nil || len(entries) != 0 {
t.Fatalf("task_2-scoped entries after DeleteAll = %v (err=%v), want none", entries, err)
}
}
// TestStoreDeleteAllDoesNotTouchOtherPlugins pins the plugin-isolation
// invariant: DeleteAll for one plugin must never remove another plugin's
// state.
func TestStoreDeleteAllDoesNotTouchOtherPlugins(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_1", "sync_status", json.RawMessage(`"PROJ-1"`)); err != nil {
t.Fatalf("set jira: %v", err)
}
if err := store.Set(ctx, "kandev-plugin-slack", "task", "task_1", "channel", json.RawMessage(`"#dev"`)); err != nil {
t.Fatalf("set slack: %v", err)
}
if err := store.DeleteAll(ctx, "kandev-plugin-jira"); err != nil {
t.Fatalf("DeleteAll: %v", err)
}
entries, err := store.List(ctx, "kandev-plugin-slack", "task", "task_1")
if err != nil {
t.Fatalf("list slack: %v", err)
}
if len(entries) != 1 {
t.Fatalf("kandev-plugin-slack entries after deleting kandev-plugin-jira = %d, want 1 (untouched)", len(entries))
}
}
// TestStoreDeleteAllMissingPluginIsNotAnError pins that DeleteAll on a
// plugin with no stored state is a safe no-op.
func TestStoreDeleteAllMissingPluginIsNotAnError(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
if err := store.DeleteAll(ctx, "kandev-plugin-never-had-state"); err != nil {
t.Fatalf("DeleteAll on a plugin with no state: %v", err)
}
}
func TestStoreDeleteMissingIsNotAnError(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
if err := store.Delete(ctx, "kandev-plugin-jira", "task", "task_xyz", "never_set"); err != nil {
t.Fatalf("delete missing: %v", err)
}
}
func TestStoreListReturnsOnlyMatchingScope(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_1", "a", json.RawMessage(`1`)); err != nil {
t.Fatalf("set task_1/a: %v", err)
}
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_1", "b", json.RawMessage(`2`)); err != nil {
t.Fatalf("set task_1/b: %v", err)
}
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_2", "a", json.RawMessage(`3`)); err != nil {
t.Fatalf("set task_2/a: %v", err)
}
entries, err := store.List(ctx, "kandev-plugin-jira", "task", "task_1")
if err != nil {
t.Fatalf("list: %v", err)
}
if len(entries) != 2 {
t.Fatalf("expected 2 entries for task_1, got %d: %+v", len(entries), entries)
}
keys := map[string]bool{}
for _, e := range entries {
keys[e.Key] = true
if e.UpdatedAt.IsZero() {
t.Errorf("entry %q has zero UpdatedAt", e.Key)
}
}
if !keys["a"] || !keys["b"] {
t.Fatalf("expected keys a and b, got %+v", entries)
}
}
// TestStorePluginsCannotReadEachOthersState pins the spec invariant that
// plugin state is always filtered by plugin_id (docs/specs/plugins/requirements/plugins.md
// "Plugins cannot read others' state").
func TestStorePluginsCannotReadEachOthersState(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_xyz", "sync_status", json.RawMessage(`"PROJ-1"`)); err != nil {
t.Fatalf("set: %v", err)
}
_, found, err := store.Get(ctx, "kandev-plugin-slack", "task", "task_xyz", "sync_status")
if err != nil {
t.Fatalf("get from other plugin: %v", err)
}
if found {
t.Fatalf("expected another plugin's state to be invisible")
}
entries, err := store.List(ctx, "kandev-plugin-slack", "task", "task_xyz")
if err != nil {
t.Fatalf("list from other plugin: %v", err)
}
if len(entries) != 0 {
t.Fatalf("expected no entries visible to a different plugin, got %+v", entries)
}
}
func TestStoreSetStampsUpdatedAtAsRFC3339UTC(t *testing.T) {
store := newTestStore(t)
ctx := context.Background()
before := time.Now().UTC()
if err := store.Set(ctx, "kandev-plugin-jira", "task", "task_xyz", "sync_status", json.RawMessage(`"PROJ-1"`)); err != nil {
t.Fatalf("set: %v", err)
}
after := time.Now().UTC()
entries, err := store.List(ctx, "kandev-plugin-jira", "task", "task_xyz")
if err != nil {
t.Fatalf("list: %v", err)
}
if len(entries) != 1 {
t.Fatalf("expected 1 entry, got %d", len(entries))
}
got := entries[0].UpdatedAt
if got.Location() != time.UTC {
t.Errorf("expected UpdatedAt location UTC, got %v", got.Location())
}
if got.Before(before.Add(-time.Second)) || got.After(after.Add(time.Second)) {
t.Errorf("UpdatedAt %v not within expected window [%v, %v]", got, before, after)
}
}
func TestStoreInitSchemaIsIdempotent(t *testing.T) {
conn := newSQLite(t)
if _, err := NewStore(db.NewPool(conn, conn)); err != nil {
t.Fatalf("first NewStore: %v", err)
}
if _, err := NewStore(db.NewPool(conn, conn)); err != nil {
t.Fatalf("second NewStore (re-init on existing schema): %v", err)
}
}
func newTestStore(t *testing.T) *Store {
t.Helper()
conn := newSQLite(t)
store, err := NewStore(db.NewPool(conn, conn))
if err != nil {
t.Fatalf("new store: %v", err)
}
return store
}
func newSQLite(t *testing.T) *sqlx.DB {
t.Helper()
conn, err := sqlx.Open("sqlite3", ":memory:")
if err != nil {
t.Fatalf("open sqlite: %v", err)
}
conn.SetMaxOpenConns(1)
t.Cleanup(func() { _ = conn.Close() })
return conn
}