Phase 1: accounts and sessions

Implements PLAN.md Phase 1. A client can now register, log in, manage its
devices and set its profile; an operator can create accounts and flip the
runtime switches. There are still no rooms and no real /sync.

userapi: accounts, argon2id passwords in PHC format, devices, access and
refresh tokens stored as SHA-256 hashes, account data and the admin flag.
Its storage interface is storage.UserStore, implemented once in sqlstore
with `?` placeholders; the postgres driver supplies a rebind function and
unique-violation recognition rather than keeping a second copy of thirty
statements. Timestamps in these tables are int64 milliseconds, the unit the
Client-Server API uses on the wire.

Client-Server API: register (user-interactive auth with m.login.dummy and
optional registration tokens), register/available, token validity, login
with m.login.password, logout, logout/all, refresh, account/whoami,
capabilities, devices/* with password-gated deletion, profile/*, global and
per-room account data.

GET /sync is a deliberate placeholder: it answers a valid token with an
empty but well-formed response and refuses a revoked one. Phase 1 has no
rooms, so that is the whole truth, and it is what makes session revocation
observable. Phase 4 replaces it with the syncapi.

Auth middleware resolves a bearer token (header or the legacy query
parameter) to a device and user, answering an expired token with the soft
logout the spec asks for. Rate limiting is a token bucket per endpoint class
keyed on the client address, returning M_LIMIT_EXCEEDED with retry_after_ms.

adminapi v1 under /_warp/admin/v1: admin-only auth via a normal Matrix
token, GET/PUT /federation and /registration driving internal/settings and
reporting a config-pinned switch as a 409, GET/POST /users, GET /stats.

warp create-account [--admin] creates the first account straight in the
database, so a new install with registration off has a way in.

Complement is wired up for the federation=off profile: an image meeting its
contract, an entrypoint that configures Warp entirely from WARP_*
variables, and a runner that builds, clones and executes the target set
(TestRegistration, TestLogin, TestDeviceManagement). It has not been run
yet -- there is no container runtime on the development machine -- so the
three tests' assertions were read from the Complement sources and pinned as
httptest tests instead, and CI gained a job that runs the real thing.

Also fixes a .gitignore bug from Phase 0: the unanchored `warp` pattern,
meant for the built binary, also matched the directory server/cmd/warp and
silently excluded the entire command package from the repository. The
binary patterns are now anchored to the repository root, and cmd/warp is
committed for the first time.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

server/internal/storage/sqlite/errors.go

@@ -0,0 +1,31 @@
+package sqlite
+
+import (
+	"errors"
+
+	sqlite3 "modernc.org/sqlite"
+)
+
+// SQLite extended result codes for the two constraint failures that mean
+// "that row is already there". The driver reports them numerically and does
+// not re-export the constants, so they are named here rather than left as
+// magic numbers at the call site.
+const (
+	constraintUnique     = 2067 // SQLITE_CONSTRAINT_UNIQUE
+	constraintPrimaryKey = 1555 // SQLITE_CONSTRAINT_PRIMARYKEY
+)
+
+// isUniqueViolation reports whether err is SQLite complaining about a
+// duplicate key.
+func isUniqueViolation(err error) bool {
+	var sqlErr *sqlite3.Error
+	if !errors.As(err, &sqlErr) {
+		return false
+	}
+	switch sqlErr.Code() {
+	case constraintUnique, constraintPrimaryKey:
+		return true
+	default:
+		return false
+	}
+}

server/internal/storage/sqlite/errors_test.go

@@ -0,0 +1,60 @@
+package sqlite
+
+import (
+	"database/sql"
+	"fmt"
+	"path/filepath"
+	"testing"
+)
+
+// TestIsUniqueViolation checks the error recognition against a real SQLite,
+// because it turns on an extended result code the driver does not export as
+// a constant: a version bump that changed it would otherwise turn "that name
+// is taken" into a 500.
+func TestIsUniqueViolation(t *testing.T) {
+	path := filepath.ToSlash(filepath.Join(t.TempDir(), "test.db"))
+	db, err := sql.Open("sqlite", "file:"+path)
+	if err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() { _ = db.Close() })
+
+	if _, err := db.ExecContext(t.Context(),
+		`CREATE TABLE t (pk TEXT PRIMARY KEY, uniq TEXT UNIQUE)`); err != nil {
+		t.Fatal(err)
+	}
+	insert := func(pk, uniq string) error {
+		_, err := db.ExecContext(t.Context(), `INSERT INTO t (pk, uniq) VALUES (?, ?)`, pk, uniq)
+		return err
+	}
+	if err := insert("a", "one"); err != nil {
+		t.Fatal(err)
+	}
+
+	for name, err := range map[string]error{
+		"duplicate primary key": insert("a", "two"),
+		"duplicate unique key":  insert("b", "one"),
+	} {
+		t.Run(name, func(t *testing.T) {
+			if err == nil {
+				t.Fatal("the insert should have failed")
+			}
+			if !isUniqueViolation(err) {
+				t.Errorf("isUniqueViolation(%v) = false, want true", err)
+			}
+		})
+	}
+
+	// Something that is an error but not a constraint failure.
+	_, err = db.ExecContext(t.Context(), `INSERT INTO nonexistent (x) VALUES (1)`)
+	if err == nil {
+		t.Fatal("inserting into a missing table should have failed")
+	}
+	if isUniqueViolation(err) {
+		t.Errorf("isUniqueViolation(%v) = true, want false", err)
+	}
+
+	if isUniqueViolation(nil) || isUniqueViolation(fmt.Errorf("unrelated")) {
+		t.Error("isUniqueViolation accepted something that is not a SQLite error")
+	}
+}

server/internal/storage/sqlite/migrations/0002_userapi.sql

@@ -0,0 +1,69 @@
+-- Accounts, devices, tokens and account data: the userapi tables.
+--
+-- Timestamps are milliseconds since the Unix epoch, the unit the
+-- Client-Server API uses on the wire, so values go in and out unconverted
+-- and both SQL drivers store the same numbers.
+--
+-- Tokens are stored as SHA-256 hashes, never in the clear: they are bearer
+-- credentials that by default never expire, and one hash per request is
+-- cheap next to what a leaked database dump would otherwise hand over.
+
+CREATE TABLE IF NOT EXISTS user_accounts (
+    localpart     TEXT    NOT NULL PRIMARY KEY,
+    -- An empty hash means the account has no password and cannot use
+    -- m.login.password; it is not a hash that anything can match.
+    password_hash TEXT    NOT NULL DEFAULT '',
+    display_name  TEXT    NOT NULL DEFAULT '',
+    avatar_url    TEXT    NOT NULL DEFAULT '',
+    admin         BOOLEAN NOT NULL DEFAULT 0,
+    deactivated   BOOLEAN NOT NULL DEFAULT 0,
+    created_at_ms BIGINT  NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS user_devices (
+    localpart     TEXT   NOT NULL REFERENCES user_accounts (localpart) ON DELETE CASCADE,
+    device_id     TEXT   NOT NULL,
+    display_name  TEXT   NOT NULL DEFAULT '',
+    created_at_ms BIGINT NOT NULL,
+    last_seen_ms  BIGINT NOT NULL DEFAULT 0,
+    last_seen_ip  TEXT   NOT NULL DEFAULT '',
+    user_agent    TEXT   NOT NULL DEFAULT '',
+    PRIMARY KEY (localpart, device_id)
+);
+
+CREATE TABLE IF NOT EXISTS user_access_tokens (
+    token_hash    TEXT   NOT NULL PRIMARY KEY,
+    localpart     TEXT   NOT NULL,
+    device_id     TEXT   NOT NULL,
+    created_at_ms BIGINT NOT NULL,
+    -- 0 means the token never expires.
+    expires_at_ms BIGINT NOT NULL DEFAULT 0,
+    FOREIGN KEY (localpart, device_id)
+        REFERENCES user_devices (localpart, device_id) ON DELETE CASCADE
+);
+
+-- Revoking a device deletes its tokens by this index, not by table scan.
+CREATE INDEX IF NOT EXISTS user_access_tokens_device_idx
+    ON user_access_tokens (localpart, device_id);
+
+CREATE TABLE IF NOT EXISTS user_refresh_tokens (
+    token_hash    TEXT   NOT NULL PRIMARY KEY,
+    localpart     TEXT   NOT NULL,
+    device_id     TEXT   NOT NULL,
+    created_at_ms BIGINT NOT NULL,
+    expires_at_ms BIGINT NOT NULL DEFAULT 0,
+    FOREIGN KEY (localpart, device_id)
+        REFERENCES user_devices (localpart, device_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS user_refresh_tokens_device_idx
+    ON user_refresh_tokens (localpart, device_id);
+
+CREATE TABLE IF NOT EXISTS user_account_data (
+    localpart TEXT NOT NULL REFERENCES user_accounts (localpart) ON DELETE CASCADE,
+    -- Empty for global account data; a room ID for per-room account data.
+    room_id   TEXT NOT NULL DEFAULT '',
+    data_type TEXT NOT NULL,
+    content   TEXT NOT NULL,
+    PRIMARY KEY (localpart, room_id, data_type)
+);

server/internal/storage/sqlite/sqlite.go

@@ -93,7 +93,10 @@ func Open(ctx context.Context, cfg storage.Config, log *slog.Logger) (storage.Da
 		MigrationsFS:  migrationFiles,
 		MigrationsDir: "migrations",
 		Settings:      settingsQueries,
-		Logger:        log,
+		// SQLite already uses the `?` placeholders the shared component
+		// stores are written with, so there is nothing to rebind.
+		IsUniqueViolation: isUniqueViolation,
+		Logger:            log,
 	})
 	if err != nil {
 		_ = db.Close()